WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

URL(String): Ein URL-Objekt aus Text erstellen

java.net.URL(String) erstellt aus Text ein URL-Objekt. Der Konstruktor ist seit Java 20 veraltet; für Java SE 21 wird empfohlen, URI zu verwenden und mit toURL() umzuwandeln.

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

Syntax

@Deprecated(since = "20")
public URL(String spec) throws MalformedURLException

java.net.URL(String) analysiert das Argument spec als URL. Ein fehlendes oder unbekanntes Protokoll, null oder eine Zurückweisung durch den Protokoll-Handler führt zu MalformedURLException. Diese geprüfte Ausnahme muss abgefangen oder mit throws deklariert werden.

Der Konstruktor ist seit Java 20 veraltet, bleibt aber in Java SE 21 verfügbar. Erstelle in neuem Code zunächst ein URI-Objekt und rufe dann toURL() auf. Wenn die Eingabe URI-Syntaxfehler enthalten kann, verwende new URI(spec): Der Konstruktor meldet Syntaxfehler mit der geprüften Ausnahme URISyntaxException. Verwende URI.create(spec) nur, wenn bereits feststeht, dass die Zeichenfolge eine syntaktisch gültige URI darstellt, wie bei der fest vorgegebenen Zeichenfolge im Beispiel. Bei Syntaxfehlern löst diese Methode die ungeprüfte Ausnahme IllegalArgumentException aus. Für die Umwandlung sind eine absolute URI und ein verfügbarer Protokoll-Handler erforderlich; nicht jede URI lässt sich in eine URL umwandeln.

Das Erstellen des Objekts bestätigt weder die vollständige Gültigkeit der Adresse noch die Verfügbarkeit der Ressource. Die Validierung hängt von der Implementierung des Protokoll-Handlers ab. URL kodiert Zeichen, die eine Prozentkodierung erfordern, nicht automatisch.

Das Beispiel vergleicht den älteren Konstruktor mit der empfohlenen Umwandlung und liest Bestandteile der Adresse aus, ohne die Ressource abzurufen. getRef() gibt das Fragment ohne # zurück. @SuppressWarnings("deprecation") unterdrückt die Warnung ausschließlich für diese Demonstration.

Beispiele

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

Ergebnis

example.com
/docs
q=java
intro

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