WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Stream.peek: praktische Referenz

Stream.peek: praktische Referenz: Stream.peek(action) ist eine faule Zwischenoperation, die dieselben Elemente weitergibt und den Consumer aufruft, wenn nachfolgende Stufen sie verbrauchen.

Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntax

Stream.peek(...)

Stream.peek(action) ist eine faule Zwischenoperation, die dieselben Elemente weitergibt und den Consumer aufruft, wenn nachfolgende Stufen sie verbrauchen.

Nutze peek hauptsächlich zur Diagnose von Werten zwischen Pipeline-Stufen; erforderliche Endeffekte gehören in forEach oder forEachOrdered.

Optimierung oder Kurzschluss kann einige oder alle Aufrufe auslassen; in einer parallelen Pipeline darf die Aktion in verschiedenen Threads laufen.

Die Aktion muss non-interfering und ungleich null sein; gemeinsamen Zustand muss sie selbst synchronisieren, und ohne Terminaloperation läuft sie überhaupt nicht.

Das terminale toList treibt die Pipeline: peek schreibt genau 1:2:, danach ergibt map [2, 4]; die Gesamtausgabe lautet 1:2:[2, 4].

Beispiele

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);
    }
}

Ergebnis

1:2:[2, 4]

Das terminale toList treibt die Pipeline: peek schreibt genau 1:2:, danach ergibt map [2, 4]; die Gesamtausgabe lautet 1:2:[2, 4].

Quellen