collections.checkedmap 是 java 提供的运行时类型检查机制，用于在 put、putall 等写操作时动态校验键值类型是否匹配指定泛型，防止 classcastexception，适用于原始类型 map、反射或遗留代码场景，但不检查 get、不支持新 api 且原始 map 可被绕过。
Collections.checkedMap 是 Java 提供的一种运行时类型检查机制，用于在向 Map 插入键或值时，强制校验其类型是否与指定泛型一致，从而避免因原始类型误用或类型擦除导致的 ClassCastException。它不是编译期检查，而是在每次 put、putAll 等修改操作时动态验证。
什么时候该用 checkedMap
当你无法完全依赖编译期泛型（比如使用了原始类型 Map、反射操作、遗留代码或跨模块传参），又希望尽早暴露类型错误（而不是等到取值时才抛异常），就可以用它做一层运行时防护。常见于框架封装、工具类或需要强类型约束的容器代理场景。
- 底层 Map 实例本身是原始类型（如
new HashMap()）但你希望“假装”它是Map<string integer></string> - 需要将一个非泛型 Map 安全地暴露给外部模块，防止对方插入错误类型的键/值
- 测试中模拟类型不匹配行为，验证异常路径
基本用法和注意事项
调用 Collections.checkedMap(map, keyType, valueType) 返回一个包装过的视图，所有写操作都会检查：键是否是 keyType 的实例，值是否是 valueType 的实例。注意：
- 只检查
put、putAll、replace等写入方法；get不检查（因为返回值类型由调用方决定，且泛型已擦除） - 对
null值不做类型检查（除非类型本身是NonNull类，但 Java 没有这种限制） - 返回的是不可序列化的包装器，且不支持
compute等新 API（Java 8+ 方法会直接抛UnsupportedOperationException） - 原始 map 仍可被绕过 checkedMap 直接修改，所以应确保原始 map 不被外部访问
一个典型示例
假设你有一个原始 HashMap，想把它当作 Map<string number></string> 使用：
Map rawMap = new HashMap();
Map<string number> safeMap = Collections.checkedMap(rawMap, String.class, Number.class);
safeMap.put("age", 25); // OK
safeMap.put("name", "Alice"); // OK（String 是 Number？不！但这里 value 是 String，不是 Number → 抛 ClassCastException）
</string>
上面第二行会立即抛出异常，因为 "Alice" 不是 Number 的实例。而如果没加 checkedMap，这段代码能通过编译并运行，直到某处执行 (Integer) map.get("name") 才崩溃。
替代方案对比
比起 checkedMap，更推荐的做法是：
- 从源头使用正确泛型：声明为
Map<string integer></string>并全程保持类型一致性 - 用不可变容器：如
Map.of()或ImmutableMap（Guava），天然杜绝写入错误 - 自定义封装类：在 setter 中显式校验，同时支持更多业务逻辑（如范围检查、空值策略）
checkedMap 是一种轻量级兜底手段，适合快速加固已有代码，但不应作为泛型设计缺失的长期替代。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
