Startseite / Streams / Stream.toList()
Streams Einsteiger

Stream.toList()

Das terminale toList() ersetzt das ausführliche collect(Collectors.toList()).

Code-Vergleich
✕ Java 8 
List<String> result = stream
    .filter(s -> s.length() > 3)
    .collect(Collectors.toList());
✓ Java 16+ 
List<String> result = stream
    .filter(s -> s.length() > 3)
    .toList();
Problem mit diesem Code entdeckt? Sag uns Bescheid.
Warum der moderne Weg gewinnt
📏

7 Zeichen vs. 24

.toList() ersetzt .collect(Collectors.toList()).

🔒

Unveränderlich

Die Ergebnisliste kann nicht verändert werden.

📖

Fließend

Liest sich am Ende einer Pipeline natürlich.

Alter Ansatz
Collectors.toList()
Moderner Ansatz
.toList()
Seit JDK
16
Schwierigkeitsgrad
Einsteiger
JDK-Unterstützung
Stream.toList()
Verfügbar

Weitgehend verfügbar seit JDK 16 (März 2021)

Wie es funktioniert

Stream.toList() gibt eine unveränderliche Liste zurück. Es entspricht .collect(Collectors.toUnmodifiableList()), ist aber viel kürzer. Hinweis: Das Ergebnis ist im Gegensatz zu Collectors.toList() unveränderlich.

Zugehörige Dokumentation
Stream.toList() ↗
Verwandte Muster
Collections Fortgeschritten

Unmodifiable collectors

Java 8
List<String> list = stream.collect(
    Collectors.collectingAndThen(
        Collectors.toList(),
        Collections::unmodifiableList
    )
);
Java 16+
List<String> list = stream.toList();
Hover für Modernes ➜
JDK 16+ →
Streams Experte

Stream gatherers

Java 8
// Sliding window: manual implementation
List<List<T>> windows = new ArrayList<>();
for (int i = 0; i <= list.size()-3; i++) {
    windows.add(
        list.subList(i, i + 3));
}
Java 24+
var windows = stream
    .gather(
        Gatherers.windowSliding(3)
    )
    .toList();
Hover für Modernes ➜
JDK 24+ →
Streams Fortgeschritten

Stream.iterate() with predicate

Java 8
Stream.iterate(1, n -> n * 2)
    .limit(10)
    .forEach(System.out::println);
// can't stop at a condition
Java 9+
Stream.iterate(
    1,
    n -> n < 1000,
    n -> n * 2
).forEach(IO::println);
// stops when n >= 1000
Hover für Modernes ➜
JDK 9+ →
Teilen 𝕏 🦋 in ⬡