0

0

Java中如何使用Collections.unmodifiableList

P粉602998670

P粉602998670

发布时间:2025-09-18 14:40:01

|

576人浏览过

|

来源于php中文网

原创

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 mutableList = new ArrayList<>();
        mutableList.add("Apple");
        mutableList.add("Banana");
        mutableList.add("Cherry");

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

        // 2. 创建一个不可修改的列表视图
        List 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 myList = new ArrayList<>();
,这仅仅意味着
myList
这个引用不能再指向其他列表对象了。但是,
myList
所指向的那个
ArrayList
对象本身还是可以被修改的,你可以继续
myList.add("New Item")
或者
myList.remove(0)
final
关键字约束的是引用本身,而
Collections.unmodifiableList
约束的是列表内容(通过这个视图)的可修改性。

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

ArrayList
返回出去,外部调用者一个
clear()
操作就能把你整个配置清空,那可真是灾难。这时候,用
unmodifiableList
包装一下再返回,就能有效避免这类问题。

使用
unmodifiableList
时有哪些常见的误解和陷阱?

我见过不少开发者在使用

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

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

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
这一种,它们各有千秋,适用于不同的场景。

1.

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

  • 优点: 简洁、高效,创建的集合是真正的不可变,线程安全。
  • 缺点: 不允许
    null
    元素,一旦创建就不能改变,不支持动态添加或删除。
  • 适用场景: 创建小型、固定内容的集合,例如配置项列表、常量集合等。如果你确定集合内容不会改变,并且不需要支持
    null
    ,这是最佳选择。
List 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 guavas = ImmutableList.builder()
    .add("Guava")
    .add("Mango")
    .build();
// guavas.add("Papaya"); // 抛出 UnsupportedOperationException

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

final
的,并且如果字段是可变对象,需要进行防御性拷贝。

  • 优点: 完全控制不可变性,可以根据业务需求定制。
  • 缺点: 开发成本高,需要仔细设计以确保所有路径都保持不可变。
  • 适用场景: 当内置集合无法满足你的复杂业务需求,或者你需要创建包含多种类型数据的复合不可变对象时。

在我看来,选择哪种方式,关键在于你对“不可变性”的需求程度和上下文。如果你只是想防止外部修改内部列表,

Collections.unmodifiableList
简单实用。如果你需要一个真正不可变且性能优异的固定集合,Java 9+ 的
List.of()
是个好选择。而对于更复杂的场景,Guava 的
ImmutableList
提供了更强大的工具集。理解这些选项,能帮助我们写出更健壮、更易于维护的代码。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

831

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.4万人学习

C# 教程
C# 教程

共94课时 | 6.5万人学习

Java 教程
Java 教程

共578课时 | 45.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号