Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Optional.flatMap: référence pratique

Optional.flatMap: référence pratique: Optional.flatMap(mapper) renvoie directement l’Optional produit par le mapper pour une valeur présente, sans enveloppe supplémentaire, et renvoie vide si le récepteur est vide.

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

Syntaxe

Optional.flatMap(...)

Optional.flatMap(mapper) renvoie directement l’Optional produit par le mapper pour une valeur présente, sans enveloppe supplémentaire, et renvoie vide si le récepteur est vide.

Utilise flatMap lorsqu’une fonction de recherche ou de validation renvoie déjà Optional, afin d’éviter Optional<Optional>.

Le mapper n’est pas appelé sur un récepteur vide et ses exceptions sont propagées ; ne lui confie pas un effet qui doit toujours avoir lieu.

Un mapper null ou un résultat null provoque NullPointerException ; Optional.empty() renvoyé par le mapper est un résultat valide.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

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

Résultat

42

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources