Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes