WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Collectors.collectingAndThen: praktische Referenz

Collectors.collectingAndThen: praktische Referenz: Collectors.collectingAndThen adaptiert einen downstream Collector und ruft den Finisher genau einmal auf dem fertigen Ergebnis auf; IDENTITY_FINISH entfällt.

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

Syntax

Collectors.collectingAndThen(...)

Collectors.collectingAndThen adaptiert einen downstream Collector und ruft den Finisher genau einmal auf dem fertigen Ergebnis auf; IDENTITY_FINISH entfällt.

Einsetzen, wenn die Reduktion das Zwischenergebnis sofort umformen soll, etwa eine List in eine unveränderliche Kopie.

Der Finisher läuft nicht pro Element und die characteristics des downstream Collectors bleiben nicht vollständig erhalten.

Ein leerer Stream liefert trotzdem das leere downstream Ergebnis an den Finisher; dessen Ausnahme wird weitergegeben.

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Beispiele

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of(3, 1, 2)
                .collect(java.util.stream.Collectors.collectingAndThen(
                    java.util.stream.Collectors.toList(), java.util.List::copyOf));
        System.out.println(result);
        try { result.add(4); } catch (UnsupportedOperationException error) { System.out.println("unmodifiable"); }
    }
}

Ergebnis

[3, 1, 2]
unmodifiable

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Quellen