CKTIS / Java
Objects.requireNonNull: Referenzen prüfen
In Java SE 21 gibt `Objects.requireNonNull` dieselbe Referenz zurück, sofern sie nicht `null` ist. Andernfalls löst die Methode eine Ausnahme aus. Den Inhalt prüft sie nicht.
Version: Java SE 21
Syntax
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 ist eine statische generische Methode in java.util.Objects. Ist obj nicht null, gibt sie dieselbe Referenz als T zurück. Das Ergebnis lässt sich also direkt in einer Zuweisung verwenden. Ist obj gleich null, liefert die Methode keinen Ersatzwert. Sie löst eine NullPointerException aus, es sei denn, bei der Supplier-Überladung löst get() selbst eine Ausnahme aus. In diesem Fall wird diese Ausnahme weitergegeben.
Die Variante mit einem Argument nimmt keine Meldung entgegen. Bei der String-Überladung wertet Java den Meldungsausdruck vor dem Aufruf aus, auch wenn obj nicht null ist. Bei Supplier<String> wird der Supplier-Ausdruck ebenfalls vorher ausgewertet, aber die Methode ruft get() zur Erzeugung der Meldung nur auf, wenn obj gleich null und der Supplier nicht null ist. Die ersten beiden Varianten gibt es seit Java 7, die Supplier-Variante seit Java 8. Ein null-Literal ohne Typumwandlung als zweites Argument ist mehrdeutig.
Der Konstruktor von Contact weist null für jedes seiner drei Textargumente einzeln zurück: firstName, lastName und email. Leere Zeichenketten bestehen diese Prüfung; das E-Mail-Format muss separat geprüft werden.
Prüfe in tryAdvance zuerst action und erst danach, ob der Bereich erschöpft ist. Bei einer gültigen Aktion bedeutet kein verbleibendes Element false. Ist noch ein Element vorhanden, übergibt die Methode es der Aktion und liefert nach deren normalem Abschluss true. Eine Aktion mit dem Wert null löst auch nach Erschöpfung des Bereichs eine NullPointerException aus.
Beispiele
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());
}
}
}Ergebnis
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` besteht die Prüfung, `null` für `email` löst dagegen eine Ausnahme aus. Der Bereich übergibt `7` an die Aktion, liefert danach bei einer gültigen Aktion `false` und weist beim letzten Aufruf weiterhin `null` zurück. Die Typumwandlung `(IntConsumer) null` wählt die primitive Überladung.
Zugehörige Lektionen
- Java · Lektion 8 · Fortgeschritten · Version: 2
- Java · Lektion 23 · Fortgeschritten · Version: 2
Quellen
- 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