异常教程

Java 实例 – 只读集合（一文讲透）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java 编程中，集合（Collection）是存储和操作数据的核心工具。然而，在实际开发中，我们经常需要确保某些数据在特定场景下不可被修改，例如在返回给外部接口或传递给其他模块时。此时，"只读集合"（Read-Only Collection）便成为了一种关键解决方案。本文将通过实例讲解 Java 中只读集合的实现方式、核心原理及应用场景，帮助开发者构建更安全、可靠的代码结构。

一、什么是只读集合？

1.1 基本概念

只读集合是指禁止直接修改其内容的集合对象。即使通过集合的接口（如 List、Set 或 Map）尝试添加、删除或修改元素，系统也会抛出异常。这类似于图书馆的“只读图书区”——读者可以查看书籍内容，但无法拆解或修改书页。

1.2 为什么需要只读集合？

  • 数据保护：防止意外或恶意修改关键数据。
  • 接口隔离：对外暴露数据时，避免调用方直接修改内部状态。
  • 代码安全：减少因集合被修改导致的逻辑错误或并发问题。

二、Java 中实现只读集合的常见方式

Java 提供了两种主要方式实现只读集合：Unmodifiable 集合和Immutable 集合。

2.1 Unmodifiable 集合

2.1.1 核心实现类

Java 的 java.util.Collections 工具类提供了多个静态方法，用于生成只读视图：

  • unmodifiableList(List<T> list)
  • unmodifiableSet(Set<T> set)
  • unmodifiableMap(Map<K,V> map)

2.1.2 示例代码

import java.util.Arrays;  
import java.util.Collections;  
import java.util.List;  

public class ReadOnlyListExample {  
    public static void main(String[] args) {  
        List<String> originalList = Arrays.asList("Apple", "Banana");  
        List<String> readOnlyList = Collections.unmodifiableList(originalList);  

        // 尝试修改只读列表  
        try {  
            readOnlyList.add("Orange"); // 抛出 UnsupportedOperationException  
        } catch (UnsupportedOperationException e) {  
            System.out.println("修改失败：" + e.getMessage());  
        }  
    }  
}

2.1.3 特性与局限性

  • 特性：
    • 动态同步：原始集合的修改会反映到只读视图中。
    • 高效轻量：仅包装原有集合，不复制数据。
  • 局限性：
    • 如果原始集合被修改，只读视图会“被动”变化，需确保原始集合不被外部修改。
    • 无法完全防止通过原始引用的修改（例如，如果原始列表未被安全保护）。

2.2 Immutable 集合

2.2.1 核心实现类

java.util.Immutable 类（Java 9+）和第三方库（如 Google Guava 的 ImmutableList）提供了更严格的不可变集合：

  • Google Guava 的 ImmutableList
  • Java 9 的 List.of()、Set.of() 等工厂方法

2.2.2 示例代码（使用 Guava）

import com.google.common.collect.ImmutableList;  

public class ImmutableExample {  
    public static void main(String[] args) {  
        ImmutableList<String> immutableList = ImmutableList.of("Java", "Python", "C++");  

        // 尝试修改不可变列表  
        try {  
            immutableList.add("JavaScript"); // 抛出 UnsupportedOperationException  
        } catch (UnsupportedOperationException e) {  
            System.out.println("不可变集合不可修改");  
        }  
    }  
}

2.2.3 特性与优势

  • 完全不可变：一旦创建，内容绝对不可修改，即使通过原始引用。
  • 线程安全：无需额外同步即可在多线程环境中安全使用。
  • 性能优化：底层实现通常经过高度优化，例如 ImmutableList 使用数组存储。

三、Unmodifiable 与 Immutable 的对比

特性Unmodifiable 集合Immutable 集合
数据修改可能性原始集合修改会影响只读视图内容完全不可变
线程安全性非线程安全（依赖原始集合）内置线程安全（如 Guava 实现）
性能开销低（仅包装）稍高（可能涉及数据复制）
适用场景临时保护数据长期稳定的不可变数据

四、实战案例：订单管理系统中的只读集合

4.1 场景描述

假设我们开发一个订单管理系统，需要将订单列表返回给前端，但要求前端只能查看，不能直接修改后端的订单数据。

4.2 实现方案

4.2.1 使用 UnmodifiableList

public class OrderService {  
    private List<Order> orders = new ArrayList<>();  

    // 提供给外部的只读视图  
    public List<Order> getReadOnlyOrders() {  
        return Collections.unmodifiableList(orders);  
    }  

    // 内部安全添加订单的方法  
    public void addOrder(Order order) {  
        orders.add(order);  
    }  
}

4.2.2 注意事项

  • 原始集合保护：若外部持有原始 orders 引用，仍可修改数据。需确保 orders 变量仅在类内部访问。
  • 深度不可变性：若订单对象（Order）本身包含可变字段（如 status），需进一步封装或使用不可变对象设计。

五、常见问题与解决方案

5.1 问题 1：原始集合被修改如何应对？

解决方案：

  • 使用 Immutable 集合替代 Unmodifiable，或在返回时复制数据： 
    public List<Order> getReadOnlyOrders() {  
    return Collections.unmodifiableList(new ArrayList<>(orders)); // 复制一份  
}

5.2 问题 2：如何实现自定义只读集合？

方案：

  • 通过继承集合接口（如 List），覆盖所有修改方法以抛出异常： 
    public class MyReadOnlyList<T> extends AbstractList<T> {  
    private final List<T> delegate;  

    public MyReadOnlyList(List<T> delegate) {  
        this.delegate = delegate;  
    }  

    @Override  
    public T get(int index) {  
        return delegate.get(index);  
    }  

    @Override  
    public int size() {  
        return delegate.size();  
    }  

    @Override  
    public boolean add(T t) {  
        throw new UnsupportedOperationException("此集合不可修改");  
    }  
    // 其他修改方法同理...  
}

六、最佳实践与总结

6.1 关键建议

  1. 优先使用内置工具：Collections.unmodifiable* 或 List.of() 等工厂方法，避免重复造轮子。
  2. 区分使用场景：临时保护用 Unmodifiable，长期数据用 Immutable。
  3. 防御性编程：返回只读视图时，确保原始数据的安全性（如复制或封装）。

6.2 总结

通过本文的学习，开发者可以掌握 Java 中只读集合的核心实现方式，并在实际项目中灵活应用。无论是保护关键数据、优化接口设计，还是提升代码安全性，只读集合都是 Java 开发者不可或缺的工具之一。记住，“只读”不仅是技术手段，更是设计思维的一部分——它体现了对数据状态和系统边界的清晰界定。

关键词布局示例：

  • 在标题中明确使用“Java 实例 – 只读集合”
  • 在代码示例的注释和解释中自然提及该关键词
  • 在对比表格和最佳实践中间接关联关键词

通过本文的深入讲解，读者可以全面理解 Java 实例 – 只读集合的实现逻辑与应用场景，从而在开发中更加得心应手。

最新发布

查看更多文章