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.