WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

MalformedURLException — Fehler beim Erstellen einer URL

MalformedURLException ist eine geprüfte Ausnahme aus java.net und erbt von IOException. Sie weist auf ein Problem beim Erstellen einer URL hin, etwa ein unbekanntes Protokoll oder eine vom Protokollhandler abgelehnte Eingabe; sie bedeutet nicht, dass eine Verbindung fehlgeschlagen ist.

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

Syntax

public class MalformedURLException extends IOException

public MalformedURLException()
public MalformedURLException(String msg)

MalformedURLException aus dem Paket java.net weist auf eine ungültige URL-Angabe hin: Es wurde kein zulässiges Protokoll gefunden oder die Angabe konnte nicht verarbeitet werden. Die Ausnahme erbt von IOException und ist geprüft: Code, der eine Methode aufruft, die sie deklariert, muss sie abfangen oder mit throws deklarieren.

Die Klasse bietet MalformedURLException() ohne Detailmeldung und MalformedURLException(String msg) mit der angegebenen Meldung. Diese Ausnahme ist nicht mit einem DNS-Fehler, einer verweigerten Verbindung oder einer HTTP-Fehlerantwort zu verwechseln. Das Erstellen eines URL-Objekts bestätigt weder die Verfügbarkeit der Ressource noch die vollständige Gültigkeit der Adresse; ein Teil der Validierung hängt vom Protokollhandler ab.

In Java SE 21 sind die URL-Konstruktoren veraltet. Empfohlen wird, ein URI zu erstellen und anschließend URI.toURL() aufzurufen. Diese Methode kann MalformedURLException auslösen, wenn das Protokoll unbekannt ist oder die Umwandlung fehlschlägt. Ein relatives URI führt dagegen zu IllegalArgumentException. Ungültige Syntax in URI.create(...) führt ebenfalls zu IllegalArgumentException, während der Konstruktor new URI(...) URISyntaxException auslöst.

Das Beispiel wandelt ein konstantes, absolutes URI mit dem Protokoll https in ein URL um, fängt MalformedURLException ab und gibt das Protokoll aus. Es öffnet keine Netzwerkverbindung. Für diese Eingabe lautet die erwartete Ausgabe https; der catch-Zweig wird nicht ausgeführt.

Beispiele

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

Ergebnis

https

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen