CKTIS / Java
Stream.toList: praktyczna referencja
Stream.toList: praktyczna referencja: Stream.toList() jest operacją terminalną od Java 16, która zbiera elementy w encounter order do niemodyfikowalnej List.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
Stream.toList(...)Stream.toList() jest operacją terminalną od Java 16, która zbiera elementy w encounter order do niemodyfikowalnej List.
Stosuj ją, gdy potrzebujesz migawki wyniku potoku bez dalszych zmian; gdy wymagany jest konkretny mutowalny typ, użyj Collectors.toCollection.
Każda metoda mutująca wynik zgłasza UnsupportedOperationException; nie zakładaj typu implementacji, serializowalności ani tożsamości instancji value-based.
Pusty strumień daje pustą listę, a elementy null są zachowywane; toList różni się więc kontraktem null od Collectors.toUnmodifiableList.
toList zachowuje element null, więc pierwszy wiersz to [a, null]; próba add zgłasza UnsupportedOperationException, a catch wypisuje unmodifiable.
Przykłady
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"); }
}
}
Wynik
[a, null] unmodifiable
toList zachowuje element null, więc pierwszy wiersz to [a, null]; próba add zgłasza UnsupportedOperationException, a catch wypisuje unmodifiable.