CKTIS / Java
URL(String): criar um objeto URL a partir de texto
java.net.URL(String) cria um objeto URL a partir de texto. O construtor está obsoleto desde Java 20; em Java SE 21, recomenda-se usar URI e convertê-lo com toURL().
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) analisa o argumento spec como um URL. A ausência de protocolo, um protocolo desconhecido, null ou a rejeição pelo gestor de protocolo provoca MalformedURLException. Esta exceção verificada tem de ser tratada ou declarada com throws.
O construtor está obsoleto desde Java 20, mas continua disponível em Java SE 21. Em código novo, crie primeiro um objeto URI e depois chame toURL(). Se o texto de entrada puder conter erros de sintaxe de URI, use new URI(spec): o construtor assinala esses erros com a exceção verificada URISyntaxException. Use URI.create(spec) apenas para cadeias de caracteres que já se sabe representarem URI sintaticamente válidos, como a cadeia fixa do exemplo. Em caso de erro de sintaxe, este método lança a exceção não verificada IllegalArgumentException. A conversão requer um URI absoluto e um gestor de protocolo disponível; nem todos os URI podem ser convertidos em URL.
A criação do objeto não comprova a validade completa do endereço nem a disponibilidade do recurso. A validação depende da implementação do gestor de protocolo. URL não codifica automaticamente os caracteres que requerem codificação percentual.
O exemplo compara o construtor antigo com a conversão recomendada e lê componentes do endereço sem obter o recurso. getRef() devolve o fragmento sem #. @SuppressWarnings("deprecation") suprime o aviso apenas para esta demonstração.
Exemplos
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
public class Main {
@SuppressWarnings("deprecation")
public static void main(String[] args) throws MalformedURLException {
String spec = "https://example.com/docs?q=java#intro";
URL legacy = new URL(spec);
URL preferred = URI.create(spec).toURL();
System.out.println(legacy.getHost());
System.out.println(legacy.getPath());
System.out.println(preferred.getQuery());
System.out.println(preferred.getRef());
}
}Resultado
example.com /docs q=java intro
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.