CKTIS / Java
Optional.flatMap: referência prática
Optional.flatMap: referência prática: Optional.flatMap(mapper) devolve diretamente o Optional produzido pelo mapper para um valor presente, sem outro invólucro, e devolve vazio para um recetor vazio.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
Optional.flatMap(...)Optional.flatMap(mapper) devolve diretamente o Optional produzido pelo mapper para um valor presente, sem outro invólucro, e devolve vazio para um recetor vazio.
Usa flatMap quando uma função de pesquisa ou validação já devolve Optional, evitando Optional<Optional>.
O mapper não é chamado para um recetor vazio e as suas exceções propagam-se; não o uses para um efeito que tenha sempre de ocorrer.
Um mapper null ou resultado null causa NullPointerException; Optional.empty() devolvido pelo mapper é um resultado válido.
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.
Exemplos
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
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.