Java Collections.unmodifiableList方法作用是什么

P粉602998670 2025-10-08 00:00:00 次阅读

返回指定列表的只读视图，包装原列表提供不可修改接口，任何修改操作将抛出异常；原始列表仍可被其他引用修改，因此该视图是动态的，适用于保护数据不被意外更改，常用于getter方法中实现防御性编程，确保封装性。

Java 中 Collections.unmodifiableList 方法的作用是返回一个指定列表的不可修改视图。 换句话说，它不会创建全新的独立列表，而是包装原始列表，提供一个只读的访问接口。任何试图修改这个“不可修改”列表的操作（如添加、删除、设置元素）都会抛出 UnsupportedOperationException 异常。

保护原始数据不被意外修改

当你需要将一个列表传递给外部代码，但又不希望对方改变它的内容时，可以使用这个方法。这样既能共享数据，又能保证安全性。

例如：

List original = new ArrayList<>();
original.add("A");
original.add("B");

List unmodifiable = Collections.unmodifiableList(original);
// unmodifiable.add("C"); // 这行会抛出异常

original.add("C"); // 但原始列表仍可修改
System.out.println(unmodifiable); // 输出包含 "C"，因为视图是动态的

注意：原始列表仍可被修改

返回的不可修改列表只是一个“视图”，它仍然引用原始列表。如果原始列表被其他引用修改，那么通过不可修改列表看到的内容也会变化。

这意味着：

不能通过不可修改列表修改内容
但若原始列表被其他地方修改，不可修改列表的内容也会变
要完全保护，需确保原始列表不再被其他代码持有或修改

适用于防御性编程

在设计类的 getter 方法时，如果直接返回内部列表，调用者可能修改对象状态，破坏封装。使用 unmodifiableList 可避免这类问题。

public class MyClass {
    private List data = new ArrayList<>();

    public List getData() {
        return Collections.unmodifiableList(data);
    }
}