WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Optional.flatMap: praktische Referenz

Optional.flatMap: praktische Referenz: Optional.flatMap(mapper) liefert bei vorhandenem Wert das vom Mapper erzeugte Optional ohne weitere Hülle und bei leerem Empfänger ein leeres Optional.

Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntax

Optional.flatMap(...)

Optional.flatMap(mapper) liefert bei vorhandenem Wert das vom Mapper erzeugte Optional ohne weitere Hülle und bei leerem Empfänger ein leeres Optional.

Nutze flatMap, wenn eine Such- oder Prüfungsfunktion bereits Optional liefert, um Optional<Optional> zu vermeiden.

Bei leerem Empfänger wird der Mapper nicht aufgerufen, und seine Ausnahmen werden weitergereicht; notwendige Effekte gehören nicht hinein.

Ein null-Mapper oder ein null-Ergebnis verursacht NullPointerException; Optional.empty() als Mapper-Ergebnis ist gültig.

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Beispiele

public class Main {
    public static void main(String[] args) throws Exception {
        var value = java.util.Optional.of("21").flatMap(text -> java.util.Optional.of(Integer.parseInt(text)));
        System.out.println(value.orElse(0) * 2);
    }
}

Ergebnis

42

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Quellen