Java replaceAll批量替换方法详解

Java 中的 Collections.replaceAll 方法可以用来批量替换集合中所有匹配指定旧值的元素为新值。这个方法非常适用于需要将集合中某个特定值统一替换成另一个值的场景。

方法签名

public static <T> boolean replaceAll(List<T> list, T oldVal, T newVal) 该方法属于 java.util.Collections 工具类，只能用于 List 类型的集合。

使用条件与注意事项

要正确使用 replaceAll，需要注意以下几点：

• 传入的集合必须是 List 接口的实现，比如 ArrayList、LinkedList 等，不能是 Set 或 Map。
• 集合中的元素需正确重写 equals() 方法，否则无法准确匹配 oldVal。
• 如果集合中没有匹配的元素，方法返回 false；如果有至少一个元素被替换，则返回 true。
• oldVal 可以为 null，但集合本身不能为 null，且所有操作基于 equals 判断。

基本使用示例

下面是一个简单的例子，展示如何将列表中所有的 "apple" 替换为 "orange"：

List<String> fruits = new ArrayList<>();
fruits.add("apple");
fruits.add("banana");
fruits.add("apple");
fruits.add("cherry");

boolean result = Collections.replaceAll(fruits, "apple", "orange");
System.out.println(fruits); // 输出: [orange, banana, orange, cherry]
System.out.println(result); // 输出: true

处理 null 值的情况

你也可以用它来替换 null 值：

List<String> items = Arrays.asList("a", null, "b", null);
Collections.replaceAll(items, null, "unknown");
System.out.println(items); // 输出: [a, unknown, b, unknown]

自定义对象替换

如果你在 List 中存储的是自定义对象，确保该类正确实现了 equals() 方法。例如：

class Person {
String name;
int age;

Person(String name, int age) {
this.name = name;
this.age = age;
}

@Override
public boolean equals(Object o) {
if (this == o) return true;
if (!(o instanceof Person)) return false;
Person person = (Person) o;
return age == person.age && Objects.equals(name, person.name);
}
}

List<Person> people = new ArrayList<>();
people.add(new Person("Alice", 25));
people.add(new Person("Bob", 30));
people.add(new Person("Alice", 25));

Person oldPerson = new Person("Alice", 25);
Person newPerson = new Person("Charlie", 25);
Collections.replaceAll(people, oldPerson, newPerson);

由于 equals 正确实现，两个 "Alice"/25 对象会被识别为相等，从而完成替换。

基本上就这些。只要注意类型和 equals 行为，Collections.replaceAll 就能高效完成批量替换任务。