CKTIS / Java
URL(String): een URL-object maken vanuit tekst
java.net.URL(String) maakt een URL-object vanuit tekst. De constructor is sinds Java 20 verouderd; voor Java SE 21 wordt aangeraden URI te gebruiken en met toURL() om te zetten.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) verwerkt het argument spec als een URL. Een ontbrekend of onbekend protocol, null of afwijzing door de protocolhandler veroorzaakt MalformedURLException. Deze gecontroleerde uitzondering moet worden opgevangen of met throws worden gedeclareerd.
De constructor is sinds Java 20 verouderd, maar blijft beschikbaar in Java SE 21. Maak in nieuwe code eerst een URI-object en roep daarna toURL() aan. Als de invoer URI-syntaxisfouten kan bevatten, gebruik dan new URI(spec): de constructor meldt zulke fouten met de gecontroleerde uitzondering URISyntaxException. Gebruik URI.create(spec) alleen voor tekenreeksen waarvan vooraf vaststaat dat ze syntactisch geldige URI's voorstellen, zoals de vaste tekenreeks in het voorbeeld. Bij een syntaxisfout werpt deze methode de ongecontroleerde uitzondering IllegalArgumentException op. Voor de omzetting zijn een absolute URI en een beschikbare protocolhandler vereist; niet elke URI kan een URL worden.
Het maken van het object bevestigt niet dat het adres volledig geldig is of dat de resource beschikbaar is. De validatie hangt af van de implementatie van de protocolhandler. URL codeert tekens waarvoor percentcodering nodig is niet automatisch.
Het voorbeeld vergelijkt de oudere constructor met de aanbevolen omzetting en leest onderdelen van het adres zonder de resource op te halen. getRef() retourneert het fragment zonder #. @SuppressWarnings("deprecation") onderdrukt de waarschuwing uitsluitend voor deze demonstratie.
Voorbeelden
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());
}
}Resultaat
example.com /docs q=java intro
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.