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