CKTIS / Java
URL(String): vytvorenie objektu URL z textu
java.net.URL(String) vytvára objekt URL z textu. Konštruktor je zastaraný od Javy 20; pre Java SE 21 sa odporúča použiť URI a previesť ho pomocou toURL().
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) spracuje argument spec ako URL. Chýbajúci alebo neznámy protokol, null alebo odmietnutie obslužnou rutinou protokolu spôsobí MalformedURLException. Túto kontrolovanú výnimku treba zachytiť alebo deklarovať pomocou throws.
Konštruktor je zastaraný od Javy 20, ale v Java SE 21 zostáva dostupný. V novom kóde najprv vytvorte objekt URI a potom zavolajte toURL(). Ak vstup môže obsahovať chyby v syntaxi URI, použite new URI(spec): konštruktor pri nich vyvolá kontrolovanú výnimku URISyntaxException. Metódu URI.create(spec) používajte len pre reťazce, o ktorých vopred viete, že predstavujú syntakticky platné URI, ako je pevne zadaný reťazec v príklade. Pri chybe syntaxe táto metóda vyvolá nekontrolovanú výnimku IllegalArgumentException. Prevod vyžaduje absolútne URI a dostupnú obslužnú rutinu protokolu; nie každé URI možno previesť na URL.
Vytvorenie objektu nepotvrdzuje úplnú platnosť adresy ani dostupnosť prostriedku. Overenie závisí od implementácie obslužnej rutiny protokolu. URL automaticky nekóduje znaky, ktoré vyžadujú percentuálne kódovanie.
Príklad porovnáva starší konštruktor s odporúčaným prevodom a číta časti adresy bez načítania prostriedku. getRef() vracia fragment bez #. @SuppressWarnings("deprecation") potláča upozornenie výhradne pre túto ukážku.
Prí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ýsledok
example.com /docs q=java intro
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.