Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

URL(String): creare un oggetto URL dal testo

java.net.URL(String) crea un oggetto URL dal testo. Il costruttore è deprecato da Java 20; in Java SE 21 si consiglia di usare URI e convertirlo con toURL().

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

@Deprecated(since = "20")
public URL(String spec) throws MalformedURLException

java.net.URL(String) analizza l’argomento spec come URL. Un protocollo assente o sconosciuto, null oppure il rifiuto da parte del gestore del protocollo causa MalformedURLException. Questa eccezione verificata deve essere intercettata o dichiarata con throws.

Il costruttore è deprecato da Java 20, ma resta disponibile in Java SE 21. Nel nuovo codice, crea prima un oggetto URI, poi chiama toURL(). Se il testo in ingresso può contenere errori di sintassi URI, usa new URI(spec): il costruttore segnala questi errori con l’eccezione verificata URISyntaxException. Usa URI.create(spec) solo per stringhe che sai già rappresentare URI sintatticamente validi, come la stringa fissa dell’esempio. In caso di errore di sintassi, questo metodo lancia l’eccezione non verificata IllegalArgumentException. La conversione richiede un URI assoluto e un gestore del protocollo disponibile; non tutti gli URI possono diventare URL.

La creazione dell’oggetto non garantisce la validità completa dell’indirizzo né la disponibilità della risorsa. La convalida dipende dall’implementazione del gestore del protocollo. URL non codifica automaticamente i caratteri che richiedono la codifica percentuale.

L’esempio confronta il costruttore precedente con la conversione consigliata e legge componenti dell’indirizzo senza recuperare la risorsa. getRef() restituisce il frammento senza #. @SuppressWarnings("deprecation") sopprime l’avviso esclusivamente per questa dimostrazione.

Esempi

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());
    }
}

Risultato

example.com
/docs
q=java
intro

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti