CKTIS / Java
Objects.requireNonNull — kontrola reference a chybová zpráva
Zkontrolujte povinný parametr: `Objects.requireNonNull` vrátí tutéž referenci, pokud není `null`. Pro `null` metoda běžně vyvolá `NullPointerException`. Výjimce můžete předat vlastní zprávu.
Verze: 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)V Java SE 21 je Objects.requireNonNull statická generická metoda třídy java.util.Objects. Importujte java.util.Objects, abyste mohli používat krátký název Objects. Pokud obj není null, metoda vrátí přesně tutéž referenci typu T a objekt nekopíruje. Pokud je obj rovno null, vyvolá NullPointerException místo vrácení hodnoty, ledaže zdroj zprávy sám vyvolá výjimku nebo chybu.
Použijte ji na začátku metody nebo konstruktoru, abyste u povinného parametru okamžitě odmítli null. Objects.requireNonNull(obj) nepřijímá vlastní zprávu. Ve volání Objects.requireNonNull(obj, "name must not be null") je druhým argumentem String se zprávou výjimky, nikoli náhradní hodnota. Výraz pro argument typu String se vyhodnotí před voláním, i když obj není null.
Pokud je vytvoření zprávy nákladné, můžete předat Supplier<String> z balíčku java.util.function, například Objects.requireNonNull(obj, () -> buildMessage()). Tělo lambda výrazu se provede jen tehdy, když je obj rovno null. Pokud Supplier vyvolá nekontrolovanou výjimku nebo chybu typu Error, šíří se dál beze změny a requireNonNull nevyvolá vlastní NullPointerException. Volání Objects.requireNonNull(obj, null) nelze zkompilovat, protože null odpovídá jak typu String, tak typu Supplier<String>. Jestliže vlastní zprávu nepotřebujete, použijte přetíženou variantu s jedním argumentem.
Metoda kontroluje pouze to, zda je reference null: prázdný řetězec kontrolou projde. Chcete-li null nahradit namísto odmítnutí, použijte Objects.requireNonNullElse s náhradní hodnotou různou od null.
Příklady
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());
}
}
}Výsledek
true name must not be null
První řádek je `true`, protože `==` porovnává reference a pole obsahuje tutéž referenci, která byla předána konstruktoru. Při druhém volání konstruktor vyvolá výjimku; blok `catch` vypíše pouze zprávu získanou pomocí `getMessage()`.
Související lekce
- Java · Lekce 28 · Středně pokročilá · Verze: 2