Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła