Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

URL(String): tworzenie obiektu URL z tekstu

java.net.URL(String) tworzy obiekt URL z tekstu. Konstruktor jest przestarzały od Java 20; w Java SE 21 zaleca się użycie URI i konwersję przez toURL().

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

Składnia

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

java.net.URL(String) parsuje argument spec jako adres URL. Brak protokołu, nieznany protokół, null lub odrzucenie przez obsługę protokołu powodują MalformedURLException. Ten kontrolowany wyjątek trzeba obsłużyć albo zadeklarować przez throws.

Konstruktor jest przestarzały od Java 20, ale pozostaje dostępny w Java SE 21. W nowym kodzie najpierw utwórz obiekt URI, a następnie wywołaj toURL(). Jeśli tekst wejściowy może zawierać błędy składni URI, użyj new URI(spec): konstruktor zgłasza wtedy kontrolowany wyjątek URISyntaxException. Używaj URI.create(spec) tylko wtedy, gdy z góry wiadomo, że tekst jest poprawnym składniowo URI, tak jak stały tekst w przykładzie. W przypadku błędu składni ta metoda zgłasza niekontrolowany wyjątek IllegalArgumentException. Konwersja wymaga bezwzględnego URI i dostępnej obsługi protokołu; nie każdy URI można przekształcić w URL.

Utworzenie obiektu nie dowodzi pełnej poprawności adresu ani dostępności zasobu. Zakres walidacji zależy od implementacji obsługi protokołu. URL nie koduje automatycznie znaków wymagających zapisu procentowego.

Przykład porównuje starszy konstruktor z zalecaną konwersją i odczytuje części adresu bez pobierania zasobu. getRef() zwraca fragment bez #. @SuppressWarnings("deprecation") wycisza ostrzeżenie wyłącznie na potrzeby demonstracji.

Przykłady

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

Wynik

example.com
/docs
q=java
intro

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła