CKTIS / Java
Stream.peek: référence pratique
Stream.peek: référence pratique: Stream.peek(action) est une opération intermédiaire paresseuse qui transmet les mêmes éléments et appelle le Consumer lorsque le parcours aval les consomme.
Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntaxe
Stream.peek(...)Stream.peek(action) est une opération intermédiaire paresseuse qui transmet les mêmes éléments et appelle le Consumer lorsque le parcours aval les consomme.
Utilise peek surtout pour diagnostiquer les valeurs entre étapes du pipeline ; confie les effets terminaux requis à forEach ou forEachOrdered.
Une optimisation ou un court-circuit peut omettre certains appels, voire tous ; dans un pipeline parallèle, l’action peut s’exécuter sur plusieurs threads.
L’action doit être non-interfering et non null ; elle doit synchroniser elle-même tout état partagé et ne s’exécute jamais sans opération terminale.
Le toList terminal déclenche le pipeline : peek écrit exactement 1:2:, puis map produit [2, 4] ; la sortie complète est 1:2:[2, 4].
Exemples
public class Main {
public static void main(String[] args) throws Exception {
var result = java.util.stream.Stream.of(1, 2).peek(n -> System.out.print(n + ":")).map(n -> n * 2).toList();
System.out.println(result);
}
}
Résultat
1:2:[2, 4]
Le toList terminal déclenche le pipeline : peek écrit exactement 1:2:, puis map produit [2, 4] ; la sortie complète est 1:2:[2, 4].