CKTIS / Java
URL(String): ustvarjanje objekta URL iz besedila
java.net.URL(String) ustvari objekt URL iz besedila. Konstruktor je zastarel od Jave 20; za Java SE 21 je priporočena uporaba URI in pretvorba z metodo toURL().
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) obdela argument spec kot URL. Manjkajoč ali neznan protokol, null ali zavrnitev s strani obravnavalnika protokola povzroči MalformedURLException. To preverjeno izjemo je treba ujeti ali navesti z throws.
Konstruktor je zastarel od Jave 20, vendar je v Java SE 21 še vedno na voljo. V novi kodi najprej ustvarite objekt URI in nato pokličite toURL(). Če lahko vhodno besedilo vsebuje napake v sintaksi URI-ja, uporabite new URI(spec): konstruktor ob takšni napaki sproži preverjeno izjemo URISyntaxException. Metodo URI.create(spec) uporabite samo za nize, za katere že veste, da predstavljajo sintaktično veljavne URI-je, kot je vnaprej določen niz v primeru. Ob sintaktični napaki ta metoda sproži nepreverjeno izjemo IllegalArgumentException. Pretvorba zahteva absolutni URI in razpoložljiv obravnavalnik protokola; vseh URI-jev ni mogoče pretvoriti v URL-je.
Ustvarjanje objekta ne potrjuje popolne veljavnosti naslova ali razpoložljivosti vira. Preverjanje je odvisno od izvedbe obravnavalnika protokola. URL znakov, ki zahtevajo odstotno kodiranje, ne kodira samodejno.
Primer primerja starejši konstruktor s priporočeno pretvorbo ter prebere dele naslova, ne da bi pridobil vir. getRef() vrne fragment brez #. @SuppressWarnings("deprecation") zatre opozorilo samo za to predstavitev.
Primeri
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());
}
}Rezultat
example.com /docs q=java intro
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.