Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes