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.