CKTIS / Java
Stream.peek: praktyczna referencja
Stream.peek: praktyczna referencja: Stream.peek(action) jest leniwą operacją pośrednią, która przekazuje te same elementy i wykonuje Consumer, gdy elementy są pobierane przez dalszy potok.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
Stream.peek(...)Stream.peek(action) jest leniwą operacją pośrednią, która przekazuje te same elementy i wykonuje Consumer, gdy elementy są pobierane przez dalszy potok.
Stosuj peek głównie do diagnostyki wartości między etapami potoku, a wymagane efekty końcowe wykonuj przez forEach lub forEachOrdered.
Optymalizacja albo operacja short-circuit może pominąć część lub wszystkie wywołania; w potoku równoległym akcja może działać w różnych wątkach.
Action musi być non-interfering i nie może być null; modyfikując stan współdzielony, sama zapewnia synchronizację, a bez operacji terminalnej nie wykona się wcale.
Końcowe toList wymusza potok: peek wypisuje dokładnie 1:2:, po czym map daje [2, 4], więc pełny stdout to 1:2:[2, 4].
Przykłady
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);
}
}
Wynik
1:2:[2, 4]
Końcowe toList wymusza potok: peek wypisuje dokładnie 1:2:, po czym map daje [2, 4], więc pełny stdout to 1:2:[2, 4].