0

0

在Java里不可变集合是什么_Java集合只读设计说明

P粉602998670

P粉602998670

发布时间:2026-02-07 15:29:01

|

438人浏览过

|

来源于php中文网

原创

不可变集合是内容与结构均不可变、线程安全且无隐藏可变状态的集合;Java 9+ 的 List.of() 等工厂方法和 Guava 的 ImmutableList 才是真正不可变,而 Collections.unmodifiableXXX() 仅为只读视图。

在java里不可变集合是什么_java集合只读设计说明

什么是不可变集合(Immutable Collection)

Java 里的不可变集合不是简单地用 Collections.unmodifiableXXX() 包一层——那是“只读视图”,底层仍可被原引用修改,运行时才抛 UnsupportedOperationException。真正的不可变集合(如 ImmutableListImmutableSet)必须满足:内容不可变、结构不可变、线程安全、无隐藏可变状态。

Java 9+ 原生提供了 List.of()Set.of()Map.of() 等工厂方法,它们创建的是真正不可变的集合实例;而 Guava 的 ImmutableList.copyOf()ImmutableList.builder() 也属此类。

Java 9+ List.of()Collections.unmodifiableList() 的关键区别

二者行为差异直接影响程序健壮性:

  • List.of() 返回的对象是紧凑、不可变、无空值(null 元素直接抛 NullPointerException)、不接受 null 的轻量实现;修改操作(如 add()set())会立即抛 UnsupportedOperationException,且无法通过反射或内部字段绕过
  • Collections.unmodifiableList() 只是包装了传入的 List 引用,若原始列表被其他代码修改(比如你把 ArrayList 传进去后又调用它的 add()),这个“只读视图”会同步反映变化——它根本不是不可变,只是“禁止通过它改”
  • 性能上:List.of() 创建的是专用小容量实现(如 ImmutableCollections.List12),无额外包装开销;而 unmodifiableList() 多一层代理对象

使用不可变集合时容易踩的坑

常见错误不是语法问题,而是对“不可变”的误判:

闪电说
闪电说

AI语音输入法

下载

立即学习Java免费学习笔记(深入)”;

  • 误以为 Set.of("a", "b").add("c") 会静默失败——实际编译就过不去(add() 方法根本不存在),但开发者常在 IDE 补全时选错类型,拿到的是 Set 接口而非具体实现,导致编译期没报错、运行时报错
  • Map.ofEntries(Map.entry(k, v)) 构建 map 后,试图用 put() 修改——同样直接抛异常;但更隐蔽的是:如果 entry 中的 key 或 value 本身是可变对象(比如 new StringBuilder("x")),那集合虽不可变,其元素状态仍可被外部修改
  • 从数据库或 JSON 解析拿到 ArrayList,立刻用 List.of(list.toArray()) 转——这没问题;但如果写成 List.of(list),就会把整个 ArrayList 当作单个元素放进新列表,结果变成 [oldArrayList]

什么时候该用不可变集合,什么时候不该用

核心判断依据是数据生命周期和共享场景:

  • 适合用:public static final 常量集合(如 HTTP 状态码映射表)、配置项白名单、函数式编程中的中间结果(如 Stream.collect(Collectors.toUnmodifiableList()))、DTO 字段返回值(避免调用方意外污染)
  • 不适合用:需要频繁增删改的缓存容器、作为 Builder 模式中间状态、与遗留 API 交互(某些框架要求传 ArrayList 实例才能反射设值)
  • 注意兼容性:Java 8 项目无法直接用 List.of(),得靠 Guava 或自行封装;而 Guava 的 Immutable* 类默认不支持 null,若业务逻辑允许 null 元素,必须显式用 ImmutableList.nullableCopyOf()

不可变性不是银弹——它解决的是“谁在什么时候能改什么”的控制权问题。一旦你把一个集合声明为不可变,就等于放弃了所有后续修改意图;如果那个集合本该承载变化,强行不可变只会让代码绕路、加锁、或复制,反而更重。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

430

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

541

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

313

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

79

2025.09.10

guava包作用
guava包作用

guava是一个java库,增强了java标准库,提供更有效率和易于使用的集合、实用程序、缓存和并发工具。想了解更多guava的相关内容,可以阅读本专题下面的文章。

265

2024.05.29

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

241

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

621

2024.03.01

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1514

2023.10.24

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

2

2026.02.06

热门下载

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

精品课程

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

共23课时 | 3.3万人学习

C# 教程
C# 教程

共94课时 | 8.8万人学习

Java 教程
Java 教程

共578课时 | 59.5万人学习

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

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