Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła