CKTIS / Java
Stream.peek: referência prática
Stream.peek: referência prática: Stream.peek(action) é uma operação intermédia lazy que encaminha os mesmos elementos e chama o Consumer quando o percurso a jusante os consome.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
Stream.peek(...)Stream.peek(action) é uma operação intermédia lazy que encaminha os mesmos elementos e chama o Consumer quando o percurso a jusante os consome.
Usa peek sobretudo para diagnosticar valores entre etapas do pipeline; executa efeitos terminais obrigatórios com forEach ou forEachOrdered.
Uma otimização ou curto-circuito pode omitir algumas ou todas as chamadas; num pipeline paralelo a ação pode correr em threads diferentes.
A ação tem de ser non-interfering e não null; deve sincronizar o estado partilhado e não é executada sem uma operação terminal.
O toList terminal executa o pipeline: peek escreve exatamente 1:2:, depois map produz [2, 4]; o stdout completo é 1:2:[2, 4].
Exemplos
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]
O toList terminal executa o pipeline: peek escreve exatamente 1:2:, depois map produz [2, 4]; o stdout completo é 1:2:[2, 4].