CKTIS / Java
Objects.requireNonNull — controllo dei riferimenti e messaggi di errore
Controlla un parametro obbligatorio: `Objects.requireNonNull` restituisce lo stesso riferimento se non è `null`. Se è `null`, di norma lancia una `NullPointerException`. Puoi fornire un messaggio personalizzato.
Versione: Java SE 21
Sintassi
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, Objects.requireNonNull è un metodo generico statico della classe java.util.Objects. Importa java.util.Objects per usare il nome breve Objects. Se obj non è null, il metodo restituisce esattamente lo stesso riferimento di tipo T, senza copiare l’oggetto. Se obj è null, lancia una NullPointerException anziché restituire un valore, a meno che il fornitore del messaggio non lanci a sua volta un’eccezione o un errore.
Usalo all’inizio di un metodo o di un costruttore per rifiutare subito null per un parametro obbligatorio. Objects.requireNonNull(obj) non accetta un messaggio personalizzato. In Objects.requireNonNull(obj, "name must not be null"), il secondo argomento è una String usata come messaggio dell’eccezione, non come valore alternativo. L’espressione dell’argomento String viene valutata prima della chiamata, anche se obj non è null.
Se produrre il messaggio è costoso, puoi passare un Supplier<String> di java.util.function, come in Objects.requireNonNull(obj, () -> buildMessage()). Il corpo della lambda viene eseguito solo se obj è null. Se il fornitore lancia un’eccezione non controllata o un Error, l’eccezione o l’errore si propaga senza modifiche e requireNonNull non lancia una propria NullPointerException. Objects.requireNonNull(obj, null) non compila perché null è compatibile sia con String sia con Supplier<String>. Usa la variante con un solo argomento se non ti serve un messaggio personalizzato.
Il metodo verifica solo se il riferimento è null: una stringa vuota supera il controllo. Per sostituire null anziché rifiutarlo, usa Objects.requireNonNullElse con un valore alternativo diverso da null.
Esempi
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());
}
}
}Risultato
true name must not be null
La prima riga è `true` perché `==` confronta i riferimenti e il campo contiene lo stesso riferimento passato al costruttore. Alla seconda chiamata il costruttore lancia un’eccezione; il blocco `catch` stampa solo il messaggio ottenuto con `getMessage()`.
Lezioni correlate
- Java · Lezione 28 · Intermedio · Versione: 2