Collecting to immutable collections

For this lesson, we'll focus on the stream-side choices: Stream.toList(), Collectors.toUnmodifiableList/Set/Map, Java 8 collectingAndThen, List.copyOf, Guava immutable collectors, null handling and duplicate policies. The broader collection taxonomy is covered in Immutable collections, so we won't re-teach factory methods except where they affect stream results.

01Picture it first: freeze at the boundary

Picture a stream pipeline as a prep table. While you're cooking, mutable bowls are fine: add ingredients, combine batches, then plate the result. The collecting step is the handoff to the waiter, and that is where you usually want the plate covered.

Fig. 1

A stream pipeline accumulates into a mutable working container, then finishes as Stream.toList, toUnmodifiableList, collectingAndThen or a Guava ImmutableList

The important distinction is where the freeze happens. Stream.toList() and the Java 10 unmodifiable collectors return an unmodifiable result directly. collectingAndThen runs a finisher after another collector, often wrapping or copying whatever the downstream collector built.

02Immutable collection collecting under the hood

import java.util.Collections;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class ImmutableStreamResultsDemo {
    public static void main(String[] args) {
        List<String> java16 = Stream.of("card", null).toList();
        System.out.println(java16.contains(null)); // true

        List<String> java10 = Stream.of("card", "cash")
                .collect(Collectors.toUnmodifiableList());

        List<String> java8 = Stream.of("card", "cash")
                .collect(Collectors.collectingAndThen(
                        Collectors.toList(),
                        Collections::unmodifiableList
                ));

        try {
            java16.add("refund");
        } catch (UnsupportedOperationException expected) {
            System.out.println("Stream.toList result is unmodifiable");
        }
    }
}