CKTIS / Java
Objects.requireNonNull: sprawdzanie referencji
W Javie SE 21 metoda `Objects.requireNonNull` zwraca tę samą referencję, jeśli nie jest `null`, albo zgłasza wyjątek. Sprawdza obecność argumentu, nie jego treść.
Wersja: Java SE 21
Składnia
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 to statyczna metoda generyczna klasy java.util.Objects. Jeśli obj nie jest null, metoda zwraca tę samą referencję jako T, więc wyniku można użyć bezpośrednio w przypisaniu. Jeśli obj jest null, metoda nie zwraca wartości domyślnej. Zgłasza NullPointerException, chyba że w wersji z dostawcą jego get() zgłosi wyjątek — wtedy to ten wyjątek jest przekazywany dalej.
Wersja requireNonNull(obj) nie przyjmuje komunikatu. W wersji z String wyrażenie tworzące komunikat jest obliczane przed wywołaniem, nawet gdy obj nie jest null. W wersji z Supplier<String> wyrażenie przekazujące dostawcę też jest obliczane przed wywołaniem, ale metoda wywołuje jego get() w celu utworzenia komunikatu tylko wtedy, gdy obj jest null, a dostawca nie jest null. Pierwsze dwie wersje są dostępne od Javy 7, a wersja z dostawcą od Javy 8. Literał null jako drugi argument bez rzutowania jest niejednoznaczny.
Konstruktor Contact osobno odrzuca null dla każdego z trzech argumentów: firstName, lastName i email. Puste napisy nadal przechodzą to sprawdzenie, a format adresu e-mail wymaga osobnej walidacji.
W tryAdvance sprawdź action, zanim sprawdzisz, czy zakres się wyczerpał. Przy poprawnej akcji brak elementu oznacza false; jeśli jest element, metoda przekazuje go akcji i po jej normalnym zakończeniu zwraca true. Akcja null powoduje NullPointerException również po wyczerpaniu zakresu.
Przykłady
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());
}
}
}Wynik
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` przechodzi sprawdzenie, ale `null` dla `email` powoduje wyjątek. Zakres przekazuje `7` akcji, potem zwraca `false` dla poprawnej akcji, a na koniec nadal odrzuca `null`. Rzutowanie `(IntConsumer) null` wybiera przeciążenie dla typu prymitywnego.
Powiązane lekcje
- Java · Lekcja 8 · Zaawansowany · Wersja: 2
- Java · Lekcja 23 · Zaawansowany · Wersja: 2
Źródła
- 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