CKTIS / Java
Objects.requireNonNull — Referenzen prüfen und Fehlermeldungen angeben
Prüfe einen Pflichtparameter: `Objects.requireNonNull` gibt eine Referenz unverändert zurück, wenn sie nicht `null` ist. Bei `null` löst die Methode normalerweise eine `NullPointerException` aus. Eine eigene Meldung ist möglich.
Version: Java SE 21
Syntax
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)In Java SE 21 ist Objects.requireNonNull eine statische generische Methode der Klasse java.util.Objects. Importiere java.util.Objects, um den kurzen Klassennamen Objects zu verwenden. Ist obj nicht null, gibt die Methode exakt dieselbe Referenz als T zurück, ohne das Objekt zu kopieren. Ist obj null, löst sie eine NullPointerException aus, statt einen Wert zurückzugeben – es sei denn, der Supplier für die Meldung wirft selbst eine Ausnahme oder einen Fehler.
Verwende die Methode am Anfang einer Methode oder eines Konstruktors, um null für einen Pflichtparameter sofort abzulehnen. Objects.requireNonNull(obj) nimmt keine eigene Meldung entgegen. Bei Objects.requireNonNull(obj, "name must not be null") ist das zweite Argument ein String für die Meldung der Ausnahme, kein Ersatzwert. Der Ausdruck für das String-Argument wird vor dem Aufruf ausgewertet, auch wenn obj nicht null ist.
Ist das Erzeugen der Meldung aufwendig, kannst du einen Supplier<String> aus java.util.function übergeben, etwa Objects.requireNonNull(obj, () -> buildMessage()). Der Lambda-Rumpf wird nur ausgeführt, wenn obj null ist. Wirft der Supplier eine ungeprüfte Ausnahme oder einen Error, wird das geworfene Objekt unverändert weitergegeben, statt dass requireNonNull eine eigene NullPointerException auslöst. Objects.requireNonNull(obj, null) lässt sich nicht kompilieren, da null sowohl zu String als auch zu Supplier<String> passt. Verwende die Überladung mit einem Argument, wenn du keine eigene Meldung brauchst.
Die Methode prüft nur, ob die Referenz null ist: Eine leere Zeichenkette besteht die Prüfung. Wenn du null ersetzen statt ablehnen willst, verwende Objects.requireNonNullElse mit einem Ersatzwert, der nicht null ist.
Beispiele
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());
}
}
}Ergebnis
true name must not be null
Die erste Zeile lautet `true`, weil `==` Referenzen vergleicht und das Feld dieselbe Referenz enthält, die an den Konstruktor übergeben wurde. Beim zweiten Aufruf löst der Konstruktor eine Ausnahme aus; der `catch`-Block gibt nur die Meldung aus `getMessage()` aus.
Zugehörige Lektionen
- Java · Lektion 28 · Mittlere Stufe · Version: 2