WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Optional — ein Wert oder sein Fehlen

Optional<T> steht für ein Ergebnis, das entweder einen Wert enthält oder leer ist. Lerne, das Vorhandensein zu prüfen und sicher auf den Wert zuzugreifen.

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

Syntax

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

java.util.Optional<T> steht für einen Wert ungleich null oder für dessen Fehlen und wird hauptsächlich als Methodenrückgabewert verwendet. Die Optional-Referenz selbst sollte nicht null sein.

Optional.of(value) weist null mit einer NullPointerException zurück; Optional.ofNullable(value) wandelt null in ein leeres Ergebnis um. Optional.empty() erstellt ein leeres Ergebnis.

Optional.isPresent() gibt true zurück, wenn ein Wert vorhanden ist. Optional.get() gibt den Wert zurück, löst bei einem leeren Ergebnis jedoch eine NoSuchElementException aus. Das Beispiel ruft get() erst auf, nachdem es das Vorhandensein geprüft hat. Die Dokumentation empfiehlt orElseThrow() statt get(), wenn das Fehlen eines Werts eine Ausnahme auslösen soll.

Beispiele

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());
    }
}

Ergebnis

true
Ada
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen