CKTIS / Java
Optional.flatMap: referencia práctica
Optional.flatMap: referencia práctica: Optional.flatMap(mapper) devuelve directamente el Optional producido por el mapper para un valor presente, sin otra envoltura, y devuelve vacío para un receptor vacío.
Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxis
Optional.flatMap(...)Optional.flatMap(mapper) devuelve directamente el Optional producido por el mapper para un valor presente, sin otra envoltura, y devuelve vacío para un receptor vacío.
Usa flatMap cuando una función de búsqueda o validación ya devuelve Optional, evitando anidar Optional<Optional>.
El mapper no se invoca para un receptor vacío y sus excepciones se propagan; no lo uses para un efecto que deba ocurrir siempre.
Un mapper null o un resultado null causa NullPointerException; Optional.empty() devuelto por el mapper es válido.
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.
Ejemplos
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);
}
}
Resultado
42
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.