CKTIS / Java
MalformedURLException — fout bij het maken van een URL
MalformedURLException is een gecontroleerde uitzondering uit java.net en breidt IOException uit. De uitzondering wijst op een probleem bij het maken van een URL, zoals een onbekend protocol of invoer die door de handler wordt afgewezen; ze betekent niet dat een verbinding is mislukt.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException uit het pakket java.net duidt op een ongeldige URL-specificatie: er is geen geldig protocol gevonden of de specificatie kon niet worden verwerkt. De uitzondering breidt IOException uit en is gecontroleerd: code die een methode aanroept die deze uitzondering declareert, moet haar afvangen of met throws declareren.
De klasse biedt MalformedURLException() zonder gedetailleerd bericht en MalformedURLException(String msg) met het opgegeven bericht. Verwar deze uitzondering niet met een DNS-fout, een geweigerde verbinding of een HTTP-foutantwoord. Alleen het maken van een URL-object bevestigt niet dat de bron beschikbaar is of dat het adres volledig geldig is; een deel van de validatie hangt af van de protocolhandler.
In Java SE 21 zijn de URL-constructors verouderd. De aanbevolen aanpak is een URI te maken en vervolgens URI.toURL() aan te roepen. Deze methode kan MalformedURLException veroorzaken als het protocol onbekend is of de conversie mislukt. Een relatieve URI veroorzaakt daarentegen IllegalArgumentException. Ongeldige syntaxis die aan URI.create(...) wordt doorgegeven, veroorzaakt eveneens IllegalArgumentException, terwijl de constructor new URI(...) URISyntaxException veroorzaakt.
Het voorbeeld zet een constante, absolute URI met het protocol https om in een URL, vangt MalformedURLException af en drukt het protocol af. Het opent geen netwerkverbinding. Voor deze invoer is de verwachte uitvoer https; de catch-tak wordt niet uitgevoerd.
Voorbeelden
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
public class Main {
public static void main(String[] args) {
URI uri = URI.create("https://example.com/docs");
try {
URL url = uri.toURL();
System.out.println(url.getProtocol());
} catch (MalformedURLException e) {
System.out.println("Cannot construct URL");
}
}
}Resultaat
https
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.