CKTIS / Java
Objects.requireNonNull : vérifier les références
Dans Java SE 21, `Objects.requireNonNull` renvoie la même référence si elle est différente de `null`, ou lève une exception. La méthode ne valide pas le contenu de l’objet.
Version : Java SE 21
Syntaxe
import java.util.Objects;
import java.util.function.Supplier;
// Method signatures in java.util.Objects (Java SE 21):
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)Objects.requireNonNull est une méthode statique générique de java.util.Objects. Si obj n’est pas null, elle renvoie la même référence en tant que T, ce qui permet d’utiliser le résultat directement dans une affectation. Si obj vaut null, elle ne renvoie pas de valeur de remplacement. Elle lève une NullPointerException, sauf si, dans la surcharge avec Supplier, get() lève une exception : c’est alors cette exception qui se propage.
La version à un argument ne prend pas de message. Avec la surcharge String, Java évalue l’expression du message avant l’appel, même si obj n’est pas null. Avec Supplier<String>, l’expression qui fournit le Supplier est aussi évaluée avant l’appel, mais la méthode n’appelle get() pour produire le message que si obj vaut null et que le Supplier n’est pas null. Les deux premières versions existent depuis Java 7, celle avec Supplier depuis Java 8. Le littéral null comme second argument est ambigu sans conversion de type explicite.
Le constructeur de Contact rejette null séparément pour chacun de ses trois arguments texte : firstName, lastName et email. Les chaînes vides passent ce contrôle, et le format de l’adresse e-mail doit être validé séparément.
Dans tryAdvance, vérifiez action avant de tester si la plage est épuisée. Avec une action valide, l’absence d’élément restant donne false. S’il reste un élément, la méthode le transmet à l’action et renvoie true lorsque celle-ci se termine normalement. Une action null provoque une NullPointerException même après épuisement de la plage.
Exemples
import java.util.Objects;
import java.util.Spliterator;
import java.util.function.IntConsumer;
public class Main {
record Contact(String firstName, String lastName, String email) {
Contact {
Objects.requireNonNull(firstName, "firstName");
Objects.requireNonNull(lastName, "lastName");
Objects.requireNonNull(email, "email");
}
}
static final class Range implements Spliterator.OfInt {
private int next = 7;
private final int end = 8;
@Override
public boolean tryAdvance(IntConsumer action) {
Objects.requireNonNull(action, "action");
if (next >= end) {
return false;
}
action.accept(next++);
return true;
}
@Override public Spliterator.OfInt trySplit() { return null; }
@Override public long estimateSize() { return end - next; }
@Override public int characteristics() { return ORDERED | SIZED; }
}
public static void main(String[] args) {
System.out.println(new Contact("Ada", "Lee", "not-an-email").email());
try {
new Contact("Ada", "Lee", null);
} catch (NullPointerException ex) {
System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
}
Range range = new Range();
IntConsumer print = System.out::println;
System.out.println(range.tryAdvance(print));
System.out.println(range.tryAdvance(print));
try {
range.tryAdvance((IntConsumer) null);
} catch (NullPointerException ex) {
System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
}
}
}Résultat
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` passe le contrôle, mais `null` pour `email` déclenche une exception. La plage transmet `7` à l’action, renvoie ensuite `false` avec une action valide, puis rejette encore `null` au dernier appel. La conversion `(IntConsumer) null` sélectionne la surcharge pour le type primitif.
Leçons associées
- Java · Leçon 8 · Avancé · Version : 2
- Java · Leçon 23 · Avancé · Version : 2
Sources
- Java SE 21 API — Objects.requireNonNull(T)
- Java SE 21 API — Objects.requireNonNull(T, String)
- Java SE 21 API — Objects.requireNonNull(T, Supplier<String>)
- Java SE 7 API — Objects
- Java SE 21 API — Spliterator.OfPrimitive.tryAdvance(T_CONS)
- Java SE 21 API — Spliterator.OfInt
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §15.12.2.5 Choosing the Most Specific Method