CKTIS / Java
Optional — hodnota, nebo její absence
Optional<T> představuje výsledek, který obsahuje hodnotu, nebo je prázdný. Naučte se ověřit přítomnost hodnoty a bezpečně k ní přistupovat.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Optional<T> result = Optional.ofNullable(value);
boolean present = result.isPresent();
if (result.isPresent()) {
T item = result.get();
}java.util.Optional<T> představuje hodnotu odlišnou od null, nebo její absenci, a používá se hlavně jako výsledek metody. Samotná reference Optional by neměla být null.
Optional.of(value) odmítne null vyhozením výjimky NullPointerException; Optional.ofNullable(value) převede null na prázdný výsledek. Optional.empty() vytvoří prázdný výsledek.
Optional.isPresent() vrátí true, pokud hodnota existuje. Optional.get() ji vrátí, ale u prázdného výsledku vyhodí výjimku NoSuchElementException. Příklad volá get() až po ověření přítomnosti hodnoty. Dokumentace upřednostňuje orElseThrow() před get(), pokud má absence hodnoty způsobit výjimku.
Příklady
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());
}
}Výsledek
true Ada false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.