WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Stream.toList: praktische Referenz

Stream.toList: praktische Referenz: Stream.toList() ist seit Java 16 eine Terminaloperation, die Elemente in Begegnungsreihenfolge in einer unveränderlichen List sammelt.

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

Syntax

Stream.toList(...)

Stream.toList() ist seit Java 16 eine Terminaloperation, die Elemente in Begegnungsreihenfolge in einer unveränderlichen List sammelt.

Nutze sie für eine Ergebnismomentaufnahme ohne spätere Änderungen; für eine bestimmte veränderliche Implementierung dient Collectors.toCollection.

Jeder Mutator des Ergebnisses wirft UnsupportedOperationException; weder Implementierungstyp, Serialisierbarkeit noch Identität der möglicherweise value-based Instanz sind zugesagt.

Ein leerer Stream ergibt eine leere Liste, und null-Elemente bleiben erhalten; der null-Vertrag unterscheidet sich daher von Collectors.toUnmodifiableList.

toList behält das null-Element, daher lautet die erste Zeile [a, null]; add wirft UnsupportedOperationException und der catch-Block schreibt unmodifiable.

Beispiele

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of("a", null).toList();
        System.out.println(result);
        try { result.add("b"); } catch (UnsupportedOperationException error) { System.out.println("unmodifiable"); }
    }
}

Ergebnis

[a, null]
unmodifiable

toList behält das null-Element, daher lautet die erste Zeile [a, null]; add wirft UnsupportedOperationException und der catch-Block schreibt unmodifiable.

Quellen