CKTIS / Java
Stream.peek: referencia práctica
Stream.peek: referencia práctica: Stream.peek(action) es una operación intermedia perezosa que deja pasar los mismos elementos e invoca el Consumer cuando el recorrido posterior los consume.
Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxis
Stream.peek(...)Stream.peek(action) es una operación intermedia perezosa que deja pasar los mismos elementos e invoca el Consumer cuando el recorrido posterior los consume.
Usa peek sobre todo para diagnosticar valores entre etapas del pipeline; realiza efectos terminales obligatorios con forEach o forEachOrdered.
Una optimización o un cortocircuito puede omitir algunas o todas las invocaciones; en un pipeline paralelo la acción puede ejecutarse en varios hilos.
La acción debe ser non-interfering y no null; ella misma sincroniza el estado compartido y no se ejecuta en absoluto sin una operación terminal.
El toList terminal impulsa el pipeline: peek escribe exactamente 1:2:, luego map produce [2, 4]; la salida completa es 1:2:[2, 4].
Ejemplos
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);
}
}
Resultado
1:2:[2, 4]
El toList terminal impulsa el pipeline: peek escribe exactamente 1:2:, luego map produce [2, 4]; la salida completa es 1:2:[2, 4].