`Stream.peek` în Java

Operații intermediare pe stream-uri Java 8

Rulează o acțiune pentru fiecare element care trece, fără să-l schimbe; folosit mai ales pentru depanare.

Sintaxă

Stream<T> peek(Consumer<? super T> actiune)

Ce face `Stream.peek`

peek(actiune) „trage cu ochiul” la elementele care trec prin acel loc al stream-ului: apelează acțiunea (de obicei o afișare) și lasă elementul să meargă mai departe neschimbat.

Este o unealtă de depanare: arată ce se întâmplă între etape și în ce ordine sunt prelucrate elementele. Nu te baza pe el pentru logica programului: dacă operația finală nu are nevoie de toate elementele (findFirst, limit, sau chiar count pe o listă de mărime cunoscută), peek poate să nu ruleze deloc pentru unele elemente.

Parametri

Parametru	Descriere
`actiune`	Un `Consumer` apelat pentru fiecare element care trece.

Ce returnează

Același stream (aceleași elemente).

Exemple

Exemplul 1: Cum trece fiecare element prin etape

Elementele nu trec întâi toate prin filter și apoi toate prin map: fiecare element parcurge tot drumul, unul după altul.

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> rezultat = List.of("ana", "dan", "ioana").stream()
                .peek(n -> System.out.println("intră:    " + n))
                .filter(n -> n.length() > 3)
                .peek(n -> System.out.println("filtrat:  " + n))
                .map(String::toUpperCase)
                .toList();
        System.out.println(rezultat);
    }
}

Rezultat

intră:    ana
intră:    dan
intră:    ioana
filtrat:  ioana
[IOANA]

Exemplul 2: peek nu rulează pentru elementele care nu sunt necesare

findFirst se oprește la primul număr par, deci restul elementelor nu ajung niciodată la peek.

import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        int primulPar = Stream.of(3, 5, 8, 11, 12)
                .peek(n -> System.out.println("verific " + n))
                .filter(n -> n % 2 == 0)
                .findFirst()
                .orElse(-1);
        System.out.println("Primul par: " + primulPar);
    }
}