CKTIS / Java
MalformedURLException — échec de création d’une URL
MalformedURLException est une exception contrôlée du package java.net, qui hérite de IOException. Elle signale un problème lors de la création d’une URL, par exemple un protocole non reconnu ou une entrée rejetée par son gestionnaire ; elle ne signifie pas qu’une connexion a échoué.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException, dans le package java.net, signale une spécification d’URL invalide : aucun protocole valide n’a été trouvé ou la spécification n’a pas pu être analysée. Elle hérite de IOException et est contrôlée : le code qui appelle une méthode la déclarant doit l’intercepter ou la déclarer avec throws.
La classe propose MalformedURLException() sans message détaillé et MalformedURLException(String msg) avec le message fourni. Ne confondez pas cette exception avec un échec DNS, un refus de connexion ou une réponse HTTP d’erreur. La seule création d’un objet URL ne garantit ni la disponibilité de la ressource ni la validité complète de l’adresse ; une partie de la validation dépend du gestionnaire de protocole.
Dans Java SE 21, les constructeurs URL sont obsolètes. La méthode recommandée consiste à créer un URI, puis à appeler URI.toURL(). Cette méthode peut lancer MalformedURLException si le protocole est inconnu ou si la conversion échoue. En revanche, un URI relatif provoque IllegalArgumentException. Une syntaxe invalide passée à URI.create(...) provoque également IllegalArgumentException, tandis que le constructeur new URI(...) lance URISyntaxException.
L’exemple convertit en URL un URI constant et absolu utilisant le protocole https, intercepte MalformedURLException et affiche le protocole. Il n’ouvre aucune connexion réseau. Pour cette entrée, la sortie attendue est https ; la branche catch n’est pas exécutée.
Exemples
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");
}
}
}Résultat
https
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.