怎么利用 Collections.checkedMap() 包装映射表以确保在运行时不会存入错误类型的键值-java教程-PHP中文网

Collections.checkedMap() 是 Java 运行时类型安全检查工具，包装 Map 后在 put/putAll/compute 等写入操作时校验键值类型，不检查读取和已有数据，依赖 Class 参数做 instanceof 判断，不支持通配符泛型，适用于开发测试阶段快速暴露类型错误。

怎么利用 collections.checkedmap() 包装映射表以确保在运行时不会存入错误类型的键值

Collections.checkedMap() 是 Java 提供的运行时类型安全检查工具，用于在向 Map 插入键（key）或值（value）时，强制校验其实际类型是否与泛型声明一致。它不会改变原有 Map 的行为，而是在每次 put、putAll、compute 等修改操作时做即时检查，一旦类型不匹配就抛出 ClassCastException。

核心用法：包装已有 Map 实例

必须传入一个已创建的原始 Map（如 HashMap），以及明确的键、值类型 Class 对象：

Map safeMap = Collections.checkedMap(new HashMap(), String.class, Integer.class);

此后所有写入操作都会被拦截检查。例如：

safeMap.put("age", 25); ✅ 正常执行
safeMap.put(123, "hello"); ❌ 运行时报 ClassCastException（键不是 String）
safeMap.put("name", "Alice"); ❌ 运行时报错（值不是 Integer）

只检查写入，不检查读取和构造

checkedMap 不会对已有数据做初始化扫描，也不检查 get() 返回值类型（因为泛型擦除后无法验证）。它只在 插入/更新 时校验新键值的类型：

如果用非泛型 Map 初始化（如 new HashMap()），再用 checkedMap 包装，它不会清理已有非法元素
建议在 Map 创建后**立即包装**，避免中间插入错误类型
读操作（get、entrySet() 等）仍按原逻辑返回，但返回值需由调用方自行保证类型安全

注意泛型擦除与运行时限制

checkedMap 依赖 Class 参数做 instanceof 判断，因此有以下约束：

不能用于带通配符或复杂泛型的类型（如 List<string></string> 作为 value 类型需传 List.class，但无法区分 List<string></string> 和 List<integer></integer>）
对基本类型包装类有效（Integer.class），但不能传 int.class（会抛 IllegalArgumentException）
子类实例允许（如 safeMap.put("k", new AtomicInteger(1)) 会通过，若 value 类型是 Number.class）