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 MalformedURLExceptionjava.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.