Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

NullPointerException — użycie null zamiast obiektu

NullPointerException (NPE) sygnalizuje użycie null tam, gdzie wymagany jest obiekt. Jest podklasą RuntimeException, więc nie trzeba deklarować go w throws.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new NullPointerException()
new NullPointerException("message")

java.lang.NullPointerException oznacza próbę użycia null tam, gdzie potrzebny jest obiekt. Typowe przyczyny to wywołanie metody instancji, dostęp do pola lub elementu tablicy, odczyt długości tablicy przez referencję null oraz throw null.

Jako podklasa RuntimeException jest wyjątkiem niekontrolowanym: nie wymaga deklaracji throws. Zalecana praktyka to ustalenie, skąd pochodzi brakująca wartość, i sprawdzenie lub poprawienie danych przed ich użyciem, zamiast ukrywania błędu przez szeroki catch.

Konstruktory NullPointerException() i NullPointerException(String message) tworzą wyjątek bez jawnego komunikatu lub z komunikatem. Nie zakładaj stałej treści komunikatu generowanego przez JVM: getMessage() może zwrócić tekst zależny od implementacji albo null.

W przykładzie text.length() zgłasza wyjątek przed wypisaniem długości. catch służy wyłącznie demonstracji i wypisuje stały tekst, niezależny od diagnostyki JVM.

Przykłady

public class Main {
    public static void main(String[] args) {
        String text = null;
        try {
            System.out.println(text.length());
        } catch (NullPointerException exception) {
            System.out.println("NullPointerException");
        }
    }
}

Wynik

NullPointerException

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła