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.