CKTIS / Java
URL(String): crear un objeto URL a partir de texto
java.net.URL(String) crea un objeto URL a partir de texto. El constructor está obsoleto desde Java 20; en Java SE 21 se recomienda usar URI y convertirlo con toURL().
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
@Deprecated(since = "20")
public URL(String spec) throws MalformedURLExceptionjava.net.URL(String) analiza el argumento spec como una URL. La ausencia de protocolo, un protocolo desconocido, null o el rechazo por parte del controlador de protocolo provoca MalformedURLException. Esta excepción comprobada debe capturarse o declararse con throws.
El constructor está obsoleto desde Java 20, pero sigue disponible en Java SE 21. En código nuevo, crea primero un objeto URI y después llama a toURL(). Si el texto de entrada puede contener errores de sintaxis de URI, usa new URI(spec): el constructor indica esos errores mediante la excepción comprobada URISyntaxException. Usa URI.create(spec) solo con cadenas que ya se sabe que representan URI sintácticamente válidos, como la cadena fija del ejemplo. Ante un error de sintaxis, este método lanza la excepción no comprobada IllegalArgumentException. La conversión requiere un URI absoluto y un controlador de protocolo disponible; no todos los URI se pueden convertir en URL.
Crear el objeto no garantiza la validez completa de la dirección ni la disponibilidad del recurso. La validación depende de la implementación del controlador de protocolo. URL no codifica automáticamente los caracteres que requieren codificación porcentual.
El ejemplo compara el constructor antiguo con la conversión recomendada y lee componentes de la dirección sin obtener el recurso. getRef() devuelve el fragmento sin #. @SuppressWarnings("deprecation") suprime la advertencia únicamente para esta demostración.
Ejemplos
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
public class Main {
@SuppressWarnings("deprecation")
public static void main(String[] args) throws MalformedURLException {
String spec = "https://example.com/docs?q=java#intro";
URL legacy = new URL(spec);
URL preferred = URI.create(spec).toURL();
System.out.println(legacy.getHost());
System.out.println(legacy.getPath());
System.out.println(preferred.getQuery());
System.out.println(preferred.getRef());
}
}Resultado
example.com /docs q=java intro
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.