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

CKTIS / Java

Objects.requireNonNull — vérifier une référence et préciser le message d’erreur

Vérifiez un paramètre obligatoire : `Objects.requireNonNull` renvoie la même référence si elle n’est pas `null`. Si elle vaut `null`, la méthode lève normalement une `NullPointerException`, avec un message personnalisé si besoin.

Version : Java SE 21

Syntaxe

import java.util.Objects;
import java.util.function.Supplier;

// Java SE 21: static method signatures in java.util.Objects
public static <T> T requireNonNull(T obj)
public static <T> T requireNonNull(T obj, String message)
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier)

Dans Java SE 21, Objects.requireNonNull est une méthode générique statique de la classe java.util.Objects. Importez java.util.Objects pour utiliser le nom court Objects. Si obj n’est pas null, la méthode renvoie exactement la même référence, de type T, sans copier l’objet. Si obj vaut null, elle lève une NullPointerException au lieu de renvoyer une valeur, sauf si le fournisseur du message lève lui-même une exception ou une erreur.

Utilisez cette méthode au début d’une méthode ou d’un constructeur pour refuser immédiatement null pour un paramètre obligatoire. Objects.requireNonNull(obj) n’accepte pas de message personnalisé. Dans Objects.requireNonNull(obj, "name must not be null"), le second argument est un String qui sert de message à l’exception, et non de valeur de remplacement. L’expression de l’argument String est évaluée avant l’appel, même si obj n’est pas null.

Si la construction du message est coûteuse, vous pouvez passer un Supplier<String> de java.util.function, comme dans Objects.requireNonNull(obj, () -> buildMessage()). Le corps de la lambda ne s’exécute que si obj vaut null. Si le fournisseur lève une exception non vérifiée ou une erreur de type Error, celle-ci se propage telle quelle et requireNonNull ne lève pas sa propre NullPointerException. Objects.requireNonNull(obj, null) ne compile pas, car null correspond à la fois à String et à Supplier<String>. Utilisez la surcharge à un seul argument si vous n’avez pas besoin d’un message personnalisé.

La méthode vérifie seulement si la référence vaut null : une chaîne vide passe le contrôle. Pour remplacer null au lieu de le refuser, utilisez Objects.requireNonNullElse avec une valeur de remplacement non null.

Exemples

import java.util.Objects;

public class Main {
    private final String name;

    public Main(String name) {
        this.name = Objects.requireNonNull(name, "name must not be null");
    }

    public static void main(String[] args) {
        String name = "Ada";
        Main entry = new Main(name);
        System.out.println(entry.name == name);

        try {
            new Main(null);
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Résultat

true
name must not be null

La première ligne affiche `true` : `==` compare les références, et le champ contient celle qui a été passée au constructeur. Au deuxième appel, le constructeur lève une exception ; le bloc `catch` affiche uniquement le message obtenu avec `getMessage()`.

Leçons associées

  • Java · Leçon 28 · Intermédiaire · Version : 2

Sources