Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

URL(String) : créer un objet URL à partir de texte

java.net.URL(String) crée un objet URL à partir de texte. Ce constructeur est obsolète depuis Java 20 ; pour Java SE 21, il est recommandé d’utiliser URI et de convertir avec toURL().

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

@Deprecated(since = "20")
public URL(String spec) throws MalformedURLException

java.net.URL(String) analyse l’argument spec comme une URL. L’absence de protocole, un protocole inconnu, null ou le rejet par le gestionnaire de protocole provoque une MalformedURLException. Cette exception vérifiée doit être interceptée ou déclarée avec throws.

Le constructeur est obsolète depuis Java 20, mais reste disponible dans Java SE 21. Dans le nouveau code, créez d’abord un objet URI, puis appelez toURL(). Si le texte fourni peut contenir des erreurs de syntaxe URI, utilisez new URI(spec) : le constructeur signale ces erreurs en levant l’exception vérifiée URISyntaxException. Réservez URI.create(spec) aux chaînes dont on sait déjà qu’elles représentent des URI syntaxiquement valides, comme la chaîne fixe de l’exemple. En cas d’erreur de syntaxe, cette méthode lève l’exception non vérifiée IllegalArgumentException. La conversion nécessite un URI absolu et un gestionnaire de protocole disponible ; tous les URI ne peuvent pas devenir des URL.

La création de l’objet ne garantit ni la validité complète de l’adresse ni la disponibilité de la ressource. La validation dépend de l’implémentation du gestionnaire de protocole. URL n’encode pas automatiquement les caractères qui nécessitent un encodage en pourcentage.

L’exemple compare l’ancien constructeur à la conversion recommandée et lit des composants de l’adresse sans récupérer la ressource. getRef() renvoie le fragment sans #. @SuppressWarnings("deprecation") supprime l’avertissement uniquement pour cette démonstration.

Exemples

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());
    }
}

Résultat

example.com
/docs
q=java
intro

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.

Sources