CKTIS / Java
Objects.requireNonNull: verifica dei riferimenti
In Java SE 21, `Objects.requireNonNull` restituisce lo stesso riferimento se non è `null`; altrimenti genera un’eccezione. Non convalida il contenuto dell’oggetto.
Versione: Java SE 21
Sintassi
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 è un metodo statico generico di java.util.Objects. Se obj non è null, il metodo restituisce lo stesso riferimento come T, quindi puoi usare il risultato direttamente in un’assegnazione. Se obj è null, non restituisce un valore sostitutivo. Lancia una NullPointerException, a meno che, nell’overload con Supplier, sia get() a lanciare un’eccezione: in tal caso si propaga quest’ultima.
La variante con un solo argomento non accetta un messaggio. Con l’overload String, Java valuta l’espressione del messaggio prima della chiamata, anche se obj non è null. Con Supplier<String>, Java valuta prima della chiamata anche l’espressione che fornisce il Supplier, ma il metodo invoca get() per produrre il messaggio solo se obj è null e il Supplier non è null. Le prime due varianti sono disponibili da Java 7, quella con Supplier da Java 8. Il letterale null come secondo argomento è ambiguo senza un cast.
Il costruttore di Contact rifiuta null per ciascuno dei suoi tre argomenti di testo: firstName, lastName ed email. Le stringhe vuote superano comunque il controllo e il formato dell’indirizzo e-mail va convalidato separatamente.
In tryAdvance, controlla action prima di verificare se l’intervallo è esaurito. Con un’azione valida, se non resta alcun elemento il metodo restituisce false; altrimenti passa un elemento all’azione e restituisce true quando questa termina normalmente. Un’azione null causa una NullPointerException anche a intervallo esaurito.
Esempi
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());
}
}
}Risultato
not-an-email NullPointerException: email 7 true false NullPointerException: action
`not-an-email` supera il controllo, mentre `null` come valore di `email` causa un’eccezione. L’intervallo passa `7` all’azione, poi con un’azione valida restituisce `false` e all’ultima chiamata rifiuta ancora `null`. Il cast `(IntConsumer) null` seleziona l’overload per il tipo primitivo.
Lezioni correlate
- Java · Lezione 8 · Avanzato · Versione: 2
- Java · Lezione 23 · Avanzato · Versione: 2
Fonti
- 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