Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Optional — wartość lub jej brak

Optional<T> reprezentuje wynik zawierający wartość albo pusty wynik. Poznaj sprawdzanie obecności i bezpieczny dostęp.

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

Składnia

Optional<T> result = Optional.ofNullable(value);
boolean present = result.isPresent();
if (result.isPresent()) {
    T item = result.get();
}

java.util.Optional<T> reprezentuje wartość różną od null albo jej brak, głównie jako wynik metody. Sama referencja do Optional nie powinna być null.

Optional.of(value) odrzuca null, rzucając NullPointerException; Optional.ofNullable(value) zamienia null na pusty wynik. Optional.empty() tworzy pusty wynik.

Optional.isPresent() zwraca true, gdy wartość istnieje. Optional.get() ją zwraca, ale dla pustego wyniku rzuca NoSuchElementException. Przykład wywołuje get() dopiero po sprawdzeniu obecności. Dokumentacja preferuje orElseThrow() zamiast get(), gdy brak wartości ma powodować wyjątek.

Przykłady

import java.util.Optional;

public class Main {
    public static void main(String[] args) {
        Optional<String> name = Optional.of("Ada");
        Optional<String> missing = Optional.empty();

        System.out.println(name.isPresent());
        if (name.isPresent()) {
            System.out.println(name.get());
        }
        System.out.println(missing.isPresent());
    }
}

Wynik

true
Ada
false

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

Źródła