CKTIS / Java
MalformedURLException — napaka pri ustvarjanju URL-ja
MalformedURLException je preverjena izjema iz java.net, ki deduje od IOException. Opozarja na težavo pri ustvarjanju URL-ja, na primer neznan protokol ali vhod, ki ga njegov upravljalnik zavrne; ne pomeni, da povezava ni uspela.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException iz paketa java.net opozarja na neveljavno specifikacijo URL-ja: ni bil najden veljaven protokol ali specifikacije ni bilo mogoče razčleniti. Deduje od IOException in je preverjena: koda, ki pokliče metodo, ki jo deklarira, jo mora ujeti ali deklarirati z throws.
Razred ponuja MalformedURLException() brez podrobnega sporočila in MalformedURLException(String msg) z navedenim sporočilom. Te izjeme ne zamenjujte z napako DNS, zavrnjeno povezavo ali napako v odgovoru HTTP. Samo ustvarjanje objekta URL ne potrjuje niti razpoložljivosti vira niti popolne veljavnosti naslova; del preverjanja je odvisen od upravljalnika protokola.
V Java SE 21 so konstruktorji URL zastareli. Priporočena pot je ustvariti URI in nato poklicati URI.toURL(). Ta metoda lahko sproži MalformedURLException, če je protokol neznan ali pretvorba ne uspe. Relativni URI pa povzroči IllegalArgumentException. Neveljavna sintaksa, podana v URI.create(...), prav tako povzroči IllegalArgumentException, medtem ko konstruktor new URI(...) sproži URISyntaxException.
Primer pretvori konstantni, absolutni URI s protokolom https v URL, ujame MalformedURLException in izpiše protokol. Ne odpre omrežne povezave. Za ta vhod je pričakovani izhod https; veja catch se ne izvede.
Primeri
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");
}
}
}Rezultat
https
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.