CKTIS / Java
URL(String): vytvoření objektu URL z textu
java.net.URL(String) vytváří objekt URL z textu. Konstruktor je zastaralý od Javy 20; pro Java SE 21 se doporučuje použít URI a převést ho pomocí toURL().
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) zpracuje argument spec jako URL. Chybějící nebo neznámý protokol, null nebo odmítnutí obslužnou rutinou protokolu způsobí MalformedURLException. Tuto kontrolovanou výjimku je nutné zachytit nebo deklarovat pomocí throws.
Konstruktor je zastaralý od Javy 20, ale v Java SE 21 zůstává dostupný. V novém kódu nejprve vytvořte objekt URI a poté zavolejte toURL(). Pokud vstup může obsahovat chyby v syntaxi URI, použijte new URI(spec): konstruktor při nich vyvolá kontrolovanou výjimku URISyntaxException. Metodu URI.create(spec) používejte jen pro řetězce, o nichž předem víte, že představují syntakticky platné URI, jako je pevně zadaný řetězec v příkladu. Při chybě syntaxe tato metoda vyvolá nekontrolovanou výjimku IllegalArgumentException. Převod vyžaduje absolutní URI a dostupnou obslužnou rutinu protokolu; ne každé URI lze převést na URL.
Vytvoření objektu nepotvrzuje úplnou platnost adresy ani dostupnost prostředku. Ověření závisí na implementaci obslužné rutiny protokolu. URL automaticky nekóduje znaky vyžadující procentuální kódování.
Příklad porovnává starší konstruktor s doporučeným převodem a čte části adresy, aniž by načítal prostředek. getRef() vrací fragment bez #. @SuppressWarnings("deprecation") potlačuje upozornění pouze pro tuto ukázku.
Příklady
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());
}
}Výsledek
example.com /docs q=java intro
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.