Java中如何使用Collections.unmodifiableList-java教程-PHP中文网

Java中如何使用Collections.unmodifiableList

P粉602998670

发布： 2025-09-18 14:40:01

原创

567人浏览过

Collections.unmodifiableList返回一个禁止修改操作的列表视图，原始列表的变更仍会反映其中，适用于保护数据完整性但需注意其非深拷贝、不阻止元素内部状态修改等特性。

java中如何使用collections.unmodifiablelist

Collections.unmodifiableList

登录后复制

在 Java 中用来创建一个只读的列表视图。它本身并不复制原始列表的数据，而是返回一个包装器，这个包装器阻止了通过它对底层列表进行任何修改操作（比如添加、删除、设置元素）。这意味着，如果你尝试通过这个视图修改列表，你会得到一个

UnsupportedOperationException

登录后复制

。它的核心价值在于提供一种安全机制，让你能将内部列表暴露给外部代码，同时又保证内部数据不会被意外或恶意地修改。

解决方案

使用

Collections.unmodifiableList

登录后复制

其实非常直接。你只需要将你想要保护的

List

登录后复制

对象作为参数传入它的静态方法即可。

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class UnmodifiableListDemo {
    public static void main(String[] args) {
        // 1. 创建一个普通的ArrayList
        List<String> mutableList = new ArrayList<>();
        mutableList.add("Apple");
        mutableList.add("Banana");
        mutableList.add("Cherry");

        System.out.println("原始列表: " + mutableList); // 输出: 原始列表: [Apple, Banana, Cherry]

        // 2. 创建一个不可修改的列表视图
        List<String> unmodifiableView = Collections.unmodifiableList(mutableList);
        System.out.println("不可修改视图: " + unmodifiableView); // 输出: 不可修改视图: [Apple, Banana, Cherry]

        // 3. 尝试通过不可修改视图修改列表 (会抛出异常)
        try {
            unmodifiableView.add("Date"); // 这行会抛出 UnsupportedOperationException
        } catch (UnsupportedOperationException e) {
            System.out.println("尝试修改不可修改视图失败: " + e.getMessage());
        }

        // 4. 原始列表的修改会反映在不可修改视图中
        mutableList.add("Elderberry");
        System.out.println("修改原始列表后，不可修改视图: " + unmodifiableView); // 输出: 修改原始列表后，不可修改视图: [Apple, Banana, Cherry, Elderberry]

        mutableList.remove("Banana");
        System.out.println("再次修改原始列表后，不可修改视图: " + unmodifiableView); // 输出: 再次修改原始列表后，不可修改视图: [Apple, Cherry, Elderberry]
    }
}

登录后复制

代码里很清楚地展示了，

unmodifiableView

登录后复制

本身不能被修改，但它始终反映着

mutableList

登录后复制

的最新状态。这正是它“视图”的本质。在我看来，理解这一点是正确使用它的关键。

为什么我们需要一个“不可修改”的列表？它和“常量”有什么区别？

这个问题问得很有深度，因为它触及了软件设计中的一个核心原则：防御性编程和数据封装。我们之所以需要一个“不可修改”的列表，最直接的原因就是为了保护数据完整性。想象一下，你有一个方法，它返回了一个内部状态的列表。如果外部代码拿到这个列表后随意修改，你的内部状态就会变得不可预测，这在多线程环境下尤其危险，可能导致难以追踪的 bug。通过返回一个

unmodifiableList

登录后复制

，你实际上是在说：“你可以看，但不能动。”这是一种非常有效的契约。

立即学习“Java免费学习笔记（深入）”；

至于它和“常量”的区别，这可能是很多初学者容易混淆的地方。当我们说一个变量是

final

登录后复制

的，比如

final List<String> myList = new ArrayList<>();

登录后复制

，这仅仅意味着

myList

登录后复制

这个引用不能再指向其他列表对象了。但是，

myList

登录后复制

所指向的那个

ArrayList

登录后复制

对象本身还是可以被修改的，你可以继续

myList.add("New Item")

登录后复制

或者

myList.remove(0)

登录后复制

。

final

登录后复制

关键字约束的是引用本身，而

Collections.unmodifiableList

登录后复制

约束的是列表内容（通过这个视图）的可修改性。

在我个人的开发经验中，这种机制在 API 设计中尤其重要。比如，一个类内部维护着一些配置项列表，或者缓存列表。如果你直接把内部的

ArrayList

登录后复制

返回出去，外部调用者一个

clear()

登录后复制

操作就能把你整个配置清空，那可真是灾难。这时候，用

unmodifiableList

登录后复制

包装一下再返回，就能有效避免这类问题。

使用

unmodifiableList

登录后复制

时有哪些常见的误解和陷阱？

我见过不少开发者在使用

unmodifiableList

登录后复制

时踩过坑，这主要是因为对它的工作原理理解不够透彻。

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

查看详情

一个非常常见的误解就是：它创建了一个全新的、独立的列表副本。 实际上，它只是一个包装器，一个只读的“窗口”。这意味着，如果原始列表在创建不可修改视图之后被修改了，那么这个不可修改视图也会反映出这些修改。上面代码示例中

mutableList.add("Elderberry")

登录后复制

之后

unmodifiableView

登录后复制

也会更新就证明了这一点。如果你想要一个完全独立的、不可变的副本，你需要先创建一个副本，比如

new ArrayList<>(originalList)

登录后复制

，然后再用

Collections.unmodifiableList

登录后复制

包装这个副本。

另一个容易被忽视的细节是：它只保证列表结构本身不可变，不保证列表中的元素不可变。 如果你的列表存储的是可变对象（比如你自定义的

Person

登录后复制

对象，它有

setName()

登录后复制

方法），那么即使列表是不可修改的，你仍然可以通过获取列表中的

Person

登录后复制

对象，然后调用

person.setName("New Name")

登录后复制

来修改这个对象的状态。

unmodifiableList

登录后复制

阻止的是

add

登录后复制

remove

登录后复制

set

登录后复制

等操作，它管不着你对列表内部对象引用的修改。要实现真正的深度不可变性，你需要确保列表中的所有元素本身也是不可变的，或者在返回时进行深度拷贝。

还有一点，虽然不常见，但值得一提：

Collections.unmodifiableList

登录后复制

返回的实际上是一个内部类实例，它通常不是
Serializable
登录后复制
的。如果你需要序列化一个不可修改的列表，你可能需要先将其转换为一个

Serializable

登录后复制

的列表实现（比如

ArrayList

登录后复制

），然后再进行序列化。

这些“陷阱”并非

unmodifiableList

登录后复制

的设计缺陷，而是我们作为开发者需要理解其边界和工作方式。在我看来，Java 集合框架的这种设计哲学，既提供了灵活性，也要求我们对底层机制有清晰的认知。

除了

Collections.unmodifiableList

登录后复制

，Java还有哪些提供不可变性的方式？它们各有什么适用场景？

Java 生态中，提供不可变性的方式远不止

Collections.unmodifiableList

登录后复制

这一种，它们各有千秋，适用于不同的场景。

List.of()

登录后复制

,
Set.of()
登录后复制
,
Map.of()
登录后复制
(Java 9+): 这是 Java 9 引入的工厂方法，用于创建真正意义上的不可变集合。它们返回的集合在创建后就不能再修改，任何修改操作都会抛出

UnsupportedOperationException

登录后复制

。

优点： 简洁、高效，创建的集合是真正的不可变，线程安全。
缺点： 不允许
```
null
```
登录后复制
元素，一旦创建就不能改变，不支持动态添加或删除。
适用场景： 创建小型、固定内容的集合，例如配置项列表、常量集合等。如果你确定集合内容不会改变，并且不需要支持
```
null
```
登录后复制
，这是最佳选择。

List<String> immutableFruits = List.of("Apple", "Banana", "Cherry");
// immutableFruits.add("Date"); // 抛出 UnsupportedOperationException

登录后复制

2. Guava 库的 Immutable Collections: Google Guava 库提供了更强大、更全面的不可变集合类，如

ImmutableList

登录后复制

ImmutableSet

登录后复制

ImmutableMap

登录后复制

等。它们通过

Builder

登录后复制

模式提供了更灵活的构建方式。

优点： 真正的不可变，线程安全，提供了
```
Builder
```
登录后复制
模式方便复杂集合的构建，对
```
null
```
登录后复制
元素有明确的拒绝策略（通常不允许）。性能通常优于
```
Collections.unmodifiableList
```
登录后复制
包装的
```
ArrayList
```
登录后复制
。
缺点： 需要引入第三方库。
适用场景： 当你需要构建复杂的、高度不可变的集合，并且对性能和健壮性有较高要求时。在大型项目中，Guava 的不可变集合是我的首选。

import com.google.common.collect.ImmutableList;

ImmutableList<String> guavas = ImmutableList.<String>builder()
    .add("Guava")
    .add("Mango")
    .build();
// guavas.add("Papaya"); // 抛出 UnsupportedOperationException

登录后复制

3. 自定义不可变类: 对于更复杂的数据结构，你可以自己设计不可变类。这意味着类的所有字段都是