Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti