Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 MalformedURLException

java.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.

Fontes