Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Optional.flatMap: riferimento pratico

Optional.flatMap: riferimento pratico: Optional.flatMap(mapper) restituisce direttamente l’Optional prodotto dal mapper per un valore presente, senza un altro involucro, e restituisce vuoto per un ricevitore vuoto.

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

Sintassi

Optional.flatMap(...)

Optional.flatMap(mapper) restituisce direttamente l’Optional prodotto dal mapper per un valore presente, senza un altro involucro, e restituisce vuoto per un ricevitore vuoto.

Usa flatMap quando una funzione di ricerca o validazione restituisce già Optional, evitando Optional<Optional>.

Il mapper non viene invocato per un ricevitore vuoto e le sue eccezioni si propagano; non usarlo per un effetto che deve avvenire sempre.

Un mapper null o un risultato null causa NullPointerException; Optional.empty() restituito dal mapper è valido.

L’esempio usa l’elemento documentato in un piccolo programma deterministico e confronta l’output standard esatto.

Esempi

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);
    }
}

Risultato

42

L’esempio usa l’elemento documentato in un piccolo programma deterministico e confronta l’output standard esatto.

Fonti