Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

MalformedURLException — errore nella creazione di un URL

MalformedURLException è un’eccezione controllata di java.net che estende IOException. Segnala un problema nella creazione di un URL, per esempio un protocollo sconosciuto o un input rifiutato dal relativo gestore; non significa che una connessione sia fallita.

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

Sintassi

public class MalformedURLException extends IOException

public MalformedURLException()
public MalformedURLException(String msg)

MalformedURLException, nel package java.net, segnala una specifica URL non valida: non è stato trovato un protocollo legale oppure non è stato possibile analizzare la specifica. Estende IOException ed è controllata: il codice che chiama un metodo che la dichiara deve intercettarla o dichiararla con throws.

La classe fornisce MalformedURLException() senza un messaggio dettagliato e MalformedURLException(String msg) con il messaggio specificato. Non confondere questa eccezione con un errore DNS, una connessione rifiutata o una risposta HTTP di errore. La sola creazione di un oggetto URL non conferma né la disponibilità della risorsa né la validità completa dell’indirizzo; parte della convalida dipende dal gestore del protocollo.

In Java SE 21 i costruttori URL sono obsoleti. Il percorso consigliato consiste nel creare un URI e poi chiamare URI.toURL(). Questo metodo può generare MalformedURLException se il protocollo è sconosciuto o la conversione non riesce. Un URI relativo, invece, causa IllegalArgumentException. Anche una sintassi non valida passata a URI.create(...) causa IllegalArgumentException, mentre il costruttore new URI(...) genera URISyntaxException.

L’esempio converte in un URL un URI costante e assoluto che usa il protocollo https, intercetta MalformedURLException e stampa il protocollo. Non apre alcuna connessione di rete. Per questo input, l’output previsto è https; il ramo catch non viene eseguito.

Esempi

import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;

public class Main {
    public static void main(String[] args) {
        URI uri = URI.create("https://example.com/docs");
        try {
            URL url = uri.toURL();
            System.out.println(url.getProtocol());
        } catch (MalformedURLException e) {
            System.out.println("Cannot construct URL");
        }
    }
}

Risultato

https

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