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.