只读导航映射创建方法详解

本文深入解析了如何通过 `Collections.unmodifiableNavigableMap()` 创建真正安全、完全只读且完整保留 `NavigableMap` 强大范围导航能力（如 `subMap`、`headMap`、`descendingMap`）的映射视图——关键在于必须先构建一个底层可导航的 `TreeMap`，立即用该方法包装并彻底丢弃原始引用，否则只读性形同虚设；它不是语法糖，而是一道运行时防护屏障，既阻止所有修改操作抛出异常，又让所有范围查询返回同样受保护的只读子视图，是构建高可靠性、不可变数据结构不可或缺的实战技巧。

用 Collections.unmodifiableNavigableMap() 创建一个“完全只读且支持范围导航”的映射，关键不在于这个方法本身——它只是包装器，真正需要的是先有一个底层的 NavigableMap（比如 TreeMap），再用它套一层不可修改视图。

1. 必须基于可导航的底层实现

该方法只接受 NavigableMap 类型参数，不能传 HashMap 或普通 TreeMap 的父接口（如 SortedMap）。常见可靠选择是 TreeMap：

• 确保键类型实现 Comparable，或显式传入 Comparator
• 避免使用 null 键（TreeMap 默认不允许）
• 初始化后立即包装，防止外部保留对原始 map 的引用

2. 正确创建只读视图的步骤

分三步操作，缺一不可：

• 新建一个 TreeMap（或其他 NavigableMap 实现），填入数据
• 调用 Collections.unmodifiableNavigableMap() 包装它
• 丢弃原始 TreeMap 引用，只保留返回的只读视图

示例：

NavigableMap<String, Integer> mutable = new TreeMap<>();
mutable.put("apple", 1);
mutable.put("banana", 2);
mutable.put("cherry", 3);

// ✅ 正确：立刻包装并赋值给 final 变量
final NavigableMap<String, Integer> readOnly = 
    Collections.unmodifiableNavigableMap(mutable);

// ❌ 危险：还留着 mutable 引用，别人仍可修改底层

3. 范围导航能力完全保留

包装后的视图仍支持所有 NavigableMap 的范围操作，但任何修改方法（如 put、remove、subMap 的可变重载）都会抛 UnsupportedOperationException：

• readOnly.subMap("a", true, "c", false) → 返回只读子视图
• readOnly.headMap("banana", true) → 同样只读
• readOnly.descendingMap() → 返回的逆序视图也只读

注意：这些子视图和逆序视图本身仍是 UnmodifiableNavigableMap，不是新包装，而是共享同一层防护逻辑。

4. 安全边界提醒

这个只读性是“运行时防护”，不是编译期约束：

• 如果原始 TreeMap 引用未被销毁，仍可能被意外修改，导致只读视图内容变化
• 不阻止反射或序列化攻击，仅防御常规 API 调用
• 若需深度不可变（如值对象也不可变），需额外保证 value 类型本身不可变

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~