CKTIS / Java
MalformedURLException — error al construir una URL
MalformedURLException es una excepción comprobada de java.net que hereda de IOException. Indica un problema al construir una URL, como un protocolo desconocido o una entrada rechazada por su controlador; no significa que haya fallado una conexión.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException, del paquete java.net, indica que la especificación de una URL no es válida: no se encontró un protocolo permitido o no se pudo analizar la especificación. Hereda de IOException y es comprobada: el código que llama a un método que la declara debe capturarla o declararla con throws.
La clase ofrece MalformedURLException() sin mensaje detallado y MalformedURLException(String msg) con el mensaje indicado. No confundas esta excepción con un fallo de DNS, una conexión rechazada o una respuesta HTTP de error. Crear un objeto URL no confirma por sí solo que el recurso esté disponible ni que la dirección sea completamente válida; parte de la validación depende del controlador del protocolo.
En Java SE 21, los constructores URL están obsoletos. La opción recomendada es crear un URI y después llamar a URI.toURL(). Este método puede lanzar MalformedURLException si el protocolo es desconocido o falla la conversión. En cambio, un URI relativo provoca IllegalArgumentException. La sintaxis no válida pasada a URI.create(...) también provoca IllegalArgumentException, mientras que el constructor new URI(...) lanza URISyntaxException.
El ejemplo convierte en un URL un URI constante y absoluto que usa el protocolo https, captura MalformedURLException e imprime el protocolo. No abre ninguna conexión de red. Para esta entrada, la salida esperada es https; no se ejecuta la rama catch.
Ejemplos
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");
}
}
}Resultado
https
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.