Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje