CKTIS / Java
MalformedURLException — błąd tworzenia adresu URL
MalformedURLException to wyjątek kontrolowany z pakietu java.net, dziedziczący po IOException. Sygnalizuje problem z utworzeniem adresu URL, na przykład nierozpoznany protokół lub zapis odrzucony przez jego obsługę; nie oznacza błędu połączenia.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException z pakietu java.net sygnalizuje nieprawidłową specyfikację URL: nie znaleziono prawidłowego protokołu albo nie udało się przetworzyć zapisu. Dziedziczy po IOException i jest wyjątkiem kontrolowanym: kod wywołujący metodę, która go deklaruje, musi go przechwycić lub zadeklarować przez throws.
Klasa udostępnia konstruktory MalformedURLException() bez komunikatu szczegółowego oraz MalformedURLException(String msg) z podanym komunikatem. Nie należy mylić tego wyjątku z awarią DNS, odmową połączenia ani odpowiedzią HTTP wskazującą błąd. Samo utworzenie obiektu URL nie potwierdza dostępności zasobu ani pełnej poprawności adresu; część walidacji zależy od obsługi protokołu.
W Java SE 21 konstruktory URL są przestarzałe. Zalecana ścieżka to utworzenie URI, a następnie wywołanie URI.toURL(). Ta metoda może zgłosić MalformedURLException, gdy protokół jest nieznany lub konwersja nie powiedzie się. Względny URI powoduje natomiast IllegalArgumentException. Nieprawidłowa składnia przekazana do URI.create(...) również powoduje IllegalArgumentException, a konstruktor new URI(...) zgłasza URISyntaxException.
Przykład konwertuje stały, bezwzględny URI z protokołem https na URL, przechwytuje MalformedURLException i wypisuje protokół. Nie otwiera połączenia sieciowego. Dla podanych danych oczekiwany jest wynik https; gałąź catch nie jest wykonywana.
Przykłady
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");
}
}
}Wynik
https
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.