Java中 Collections 工具类在 Spring 框架 Bean 属性注入不可变集合的应用

冰川箭仙

冰川箭仙

2026-07-13

935人浏览

原创

spring集合注入默认生成可变集合,不可变性需开发者手动封装(如collections.unmodifiablelist或list.copyof),xml配置不支持自动不可变,推荐构造注入+final字段保障不可变语义。

java中 collections 工具类在 spring 框架 bean 属性注入不可变集合的应用

Java 中 Collections 工具类本身不直接参与 Spring 的 Bean 属性注入,也不能用于创建「Spring 可识别的不可变集合」来完成属性注入。真正起作用的是 Spring 容器对集合类型(ListSetMap)的 XML 或注解配置支持,而不可变性需由开发者主动保障——Collections.unmodifiableXXX() 是运行时防护手段,不是注入机制的一部分。

Spring 集合注入本质是可变容器

Spring 在解析 <list></list><set></set><map></map> 等标签时,底层默认创建的是标准可变集合(如 ArrayListLinkedHashSetLinkedHashMap)。即使你写:

  • <list><value>a</value><value>b</value></list>
  • Spring 仍会注入一个普通 ArrayList,而非 Collections.unmodifiableList(...)

这意味着:注入后若业务代码调用 list.add(...),不会报错——它确实是可变的。

想实现不可变集合,必须手动包装

若需注入后即不可修改,应在 Bean 初始化阶段完成封装。常见做法有两种:

  • 在 setter 方法中封装public void setRoles(List<string> roles) { this.roles = Collections.unmodifiableList(new ArrayList(roles)); }</string>
  • 在构造函数中封装(推荐)**: public UserService(List<string> permissions) { this.permissions = Collections.unmodifiableList(permissions); }</string> 注意:此时需确保传入的 permissions 是副本(避免外部仍持有原始引用),否则仍可能被间接修改。

XML 配置无法自动产生不可变集合

Spring 的 XML 集合标签(<list></list> 等)不提供 immutable="true" 这类属性,也不支持调用 Collections.unmodifiableList() 这样的静态工厂方法。它只负责实例化和填充集合,不干预其运行时行为。

Java Linux版
Java Linux版

Java Linux版下载入口,提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。

下载

试图在 XML 中这样写是无效的:

  • <property name="items"><bean class="java.util.Collections" factory-method="unmodifiableList"><constructor-arg><list>...</list></constructor-arg></bean></property> —— 这不是标准用法,Spring 不识别此类嵌套工厂调用(除非自定义 FactoryBean

现代写法更倾向注解 + 构造注入 + 不可变语义

在 Spring Boot + Java 14+ 场景下,更自然的方式是:

  • @AllArgsConstructor 或显式构造函数接收集合参数
  • 字段声明为 final,并在构造中赋值并封装:this.roles = List.copyOf(roles);(Java 10+)或 Collections.unmodifiableList(...)
  • 配合 Lombok 的 @Builder 或 Record 类进一步强化不可变契约

例如:

public record Config(List endpoints) {
  public Config {
    this.endpoints = List.copyOf(endpoints); // 不可变副本
  }
}

不复杂但容易忽略:不可变性不是配置出来的,而是设计出来的。Spring 注入的是“数据”,而“是否可变”取决于你如何持有和暴露它。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

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

2023.06.15

3767

6

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

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

2023.07.05

2776

9

java自学难吗
java自学难吗

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

2023.07.31

2801

8

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

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

2023.08.01

636

3

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

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

2023.08.02

601

3

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

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

2023.08.02

705

5

java有什么用
java有什么用

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

2023.08.02

1289

5

java在线网站
java在线网站

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

2023.08.03

18844

3

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

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

646

8

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

Java 26官方文档
Java 26官方文档

共0课时 | 0人学习