Java 中怎么使用 Collections.replaceAll 批量修改列表元素-java教程-PHP中文网

collections.replaceall用于将list中所有等于oldval的元素替换为newval，要求列表可修改且元素支持equals比较；返回true表示至少替换一次，支持null值，但不支持条件替换。

java 中怎么使用 collections.replaceall 批量修改列表元素

Collections.replaceAll 是 Java 集合工具类中一个简单但实用的方法，用于将列表中所有等于指定旧值的元素，统一替换成新值。它只适用于 List，且要求元素支持 equals() 比较（比如 String、Integer 等常见类型）。

基本用法：替换所有匹配项

该方法签名是：

public static boolean replaceAll(List list, T oldVal, T newVal)

它会遍历整个列表，把每个 oldVal.equals(element) 为 true 的元素替换成 newVal，返回 true 表示至少替换了一处，否则返回 false。

原列表必须是可修改的（比如 new ArrayList()），不可修改列表（如 Arrays.asList() 返回的）会抛 UnsupportedOperationException
oldVal 可以为 null，此时匹配所有 null 元素；newVal 也可以为 null
不支持按条件替换（比如“大于 10 的数替换成 0”），仅支持“值相等”语义的批量替换

实际例子：字符串和数字替换

例如，把一个字符串列表里所有 "apple" 替换成 "orange"：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

List fruits = new ArrayList(Arrays.asList("apple", "banana", "apple", "cherry"));
Collections.replaceAll(fruits, "apple", "orange");
// fruits 变为 ["orange", "banana", "orange", "cherry"]

再比如，把整数列表中所有 0 替换为 -1：

List nums = new ArrayList(Arrays.asList(0, 1, 0, 2, 0));
Collections.replaceAll(nums, 0, -1);
// nums 变为 [-1, 1, -1, 2, -1]

注意事项：null 和自定义对象

如果列表含 null，想替换它们，直接传 null 作 oldVal 即可：

List list = Arrays.asList("a", null, "b", null);
// 注意：list 必须可修改，这里需转成 ArrayList
ArrayList modifiable = new ArrayList(list);
Collections.replaceAll(modifiable, null, "unknown");

对自定义对象使用时，务必确保其正确重写了 equals()（和 hashCode()），否则可能无法匹配成功。仅靠引用相等是不够的。