Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Objects.requireNonNull — sprawdzanie referencji i komunikat błędu

Sprawdź wymagany parametr: `Objects.requireNonNull` zwraca tę samą referencję, jeśli nie jest ona `null`. Dla `null` metoda zwykle zgłasza `NullPointerException`. W razie potrzeby podaj własny komunikat.

Wersja: Java SE 21

Składnia

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)

W Java SE 21 Objects.requireNonNull to statyczna metoda generyczna klasy java.util.Objects. Zaimportuj java.util.Objects, aby używać nazwy Objects. Jeśli obj nie jest null, metoda zwraca dokładnie tę samą referencję jako T, bez kopiowania obiektu. Jeśli obj jest null, metoda zgłasza NullPointerException zamiast zwrócić wartość, chyba że dostawca komunikatu sam zgłosi wyjątek lub błąd.

Użyj tej metody na początku metody lub konstruktora, aby od razu odrzucić null w wymaganym parametrze. Objects.requireNonNull(obj) nie przyjmuje własnego komunikatu. W Objects.requireNonNull(obj, "name must not be null") drugi argument to String używany jako komunikat wyjątku, a nie wartość domyślna. Wyrażenie przekazane jako argument String jest obliczane przed wywołaniem, nawet jeśli obj nie jest null.

Gdy przygotowanie komunikatu jest kosztowne, możesz przekazać Supplier<String> z pakietu java.util.function, na przykład Objects.requireNonNull(obj, () -> buildMessage()). Ciało lambdy wykona się tylko wtedy, gdy obj jest null. Jeśli dostawca komunikatu zgłosi wyjątek niekontrolowany lub błąd typu Error, zostanie on przekazany dalej bez zmian, a requireNonNull nie zgłosi własnego NullPointerException. Wywołanie Objects.requireNonNull(obj, null) nie kompiluje się, bo null pasuje zarówno do String, jak i do Supplier<String>. Jeśli nie potrzebujesz własnego komunikatu, użyj wersji jednoargumentowej.

Metoda sprawdza tylko, czy referencja jest null: pusty łańcuch przechodzi sprawdzenie. Jeśli chcesz zastąpić null wartością domyślną zamiast go odrzucić, użyj Objects.requireNonNullElse z niepustą w sensie referencji (różną od null) wartością domyślną.

Przykłady

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());
        }
    }
}

Wynik

true
name must not be null

Pierwsza linia to `true`, ponieważ `==` porównuje referencje i w polu zapisano tę samą referencję, którą przekazano do konstruktora. Przy drugim wywołaniu konstruktor zgłasza wyjątek; blok `catch` wypisuje tylko komunikat z `getMessage()`.

Powiązane lekcje

  • Java · Lekcja 28 · Średniozaawansowany · Wersja: 2

Źródła