Immutable Collections

📋 Quick Reference

Property	Value
Type	Collections that cannot be modified after creation
Thread Safety	Inherently thread-safe (no synchronization needed)
Memory	Compact, no defensive copying needed
Null	Not allowed in Java 9+ factory methods
Best For	Configuration, constants, return values, multi-threading

One-liner: Collections that cannot change after creation - thread-safe by design, no synchronization needed.

🎮 Interactive Visualizer

See how immutable collections work and how structural sharing saves memory:

Immutable Collections
UnmodifiableThread-safe
1 / 0
Use cases:Constants, config, shared state in concurrent apps, defensive copies
Java tip:List.of(), Set.of(), Map.of() - reject null values!
Immutable List (List.of)
Mutable Copy (ArrayList)
No Locks
Thread-safe by nature
Compact
Optimized memory
Safe Sharing
Pass freely
Pseudocode
1// Java 9+ Immutable Collections
2 
3// Creation - O(1) for small, O(n) copy
4List.of("A", "B", "C")
5Set.of(1, 2, 3)
6Map.of("k1", "v1", "k2", "v2")
7 
8// Modification attempts throw!
9list.add("D")  // UnsupportedOp!
10list.set(0, "X")  // UnsupportedOp!
11 
12// Safe derivation pattern
13var newList = new ArrayList<>(list)
14newList.add("D")  // Works!
Variables
—
Keyboard Shortcuts
P Play / Pause
[ Step back
] Step forward
R Reset
Speed
Immutable
Immutable
Mutable copy
Mutable copy
Error
Error
P · [ ] · R
Loading visualizer...

Try these operations:

See that modification throws UnsupportedOperationException
Watch "derived" collections share structure
Compare memory usage with mutable copies
Observe safe sharing between threads

🔧 Creating Immutable Collections

Java 9+ Factory Methods (Preferred)

JAVA(14 lines)
Code
Loading syntax highlighter...

From Existing Collections (Java 10+)

JAVA(15 lines)
Code
Loading syntax highlighter...

Collections.unmodifiable* (View Wrapper)

JAVA(9 lines)
Code
Loading syntax highlighter...

📊 Comparison of Approaches

Method	Type	Null?	Modifications	Thread-Safe
`List.of()`	True copy	No	Throws	Yes
`List.copyOf()`	True copy	No	Throws	Yes
`unmodifiableList()`	View	Yes	View throws, source can change	If source unchanged
`toUnmodifiableList()`	True copy	No	Throws	Yes

✅ When to Use Immutable Collections

Good Use Cases

Constants - application-wide shared values
Configuration - settings that shouldn't change
Method returns - caller can't modify your internal state
Multi-threading - no synchronization needed
Defensive copies - no need to copy if immutable
Map keys - guaranteed hashCode stability

Avoid When

Need to modify - obvious but important
Building incrementally - use builder then convert
Need null values - Java 9+ factory methods reject null

🧩 Common Patterns

Configuration Constants

JAVA(12 lines)
Code
Loading syntax highlighter...

Safe Return Values

JAVA(13 lines)
Code
Loading syntax highlighter...

Builder Pattern with Immutable Result

JAVA(28 lines)
Code
Loading syntax highlighter...

JAVA(13 lines)
Code
Loading syntax highlighter...

⚠️ Common Pitfalls

1. Confusing Unmodifiable with Immutable

JAVA(7 lines)
Code
Loading syntax highlighter...

2. Null Values

JAVA(7 lines)
Code
Loading syntax highlighter...

3. Mutable Elements in Immutable Collection

JAVA(6 lines)
Code
Loading syntax highlighter...

4. Expecting Modification to Work

JAVA(13 lines)
Code
Loading syntax highlighter...

🔄 Immutable vs Unmodifiable vs Mutable

JAVA(14 lines)
Code
Loading syntax highlighter...

🎯 Interview Practice

Test your immutable collections knowledge with 10 curated interview questions:

🎤 Immutable Collections Interview Mode - Coming Soon

🎤 Interview Tips

Q: What's the difference between immutable and unmodifiable?

"

Unmodifiable is a view wrapper that prevents direct modification but the underlying collection can still change. Immutable collections truly cannot change - there's no underlying mutable collection to modify.

Q: Why use immutable collections?

"

Thread safety without synchronization, no defensive copies needed, can be safely shared and cached, hashCode stability for map keys, and they communicate intent - "this won't change".

Q: Can I have null in List.of()?

"

No, Java 9+ factory methods throw NullPointerException for null elements. This is by design - nulls in collections are often bugs. Use Collections.unmodifiableList() if you really need nulls.

Q: How do I modify an immutable collection?

"

You create a new collection with the modification. Use streams or builders to derive new collections from existing ones. This is the functional programming approach.

Previous: Part 16: Copy-on-Write Collections

Next: Part 18: Garbage Collection

Visualizer: ImmutableCollections from @tomaszjarosz/react-visualizers

📋 Quick Reference

🎮 Interactive Visualizer