Collections.checkedSet() 是 Java 运行时类型安全包装器，需传入已有 Set 实例和 Class 类型参数，在 add/addAll 时校验元素类型，不校验 contains/remove，且仅对包装引用生效。
Collections.checkedSet() 是 Java 提供的一种运行时类型安全包装器，用于在向 Set 插入元素时强制检查泛型类型。它不会改变原集合的结构或行为，而是在每次调用 add()、addAll() 等修改方法时，对传入对象的实际运行时类型进行校验 —— 若类型不匹配，立即抛出 ClassCastException。
如何创建一个类型安全的 checkedSet
必须传入一个**已存在的 Set 实例**和其**期望的元素类型（Class 对象）**：
Set<String> rawSet = new HashSet<>(); Set<String> safeSet = Collections.checkedSet(rawSet, String.class);
注意：不能直接用泛型声明来“欺骗”类型，比如传入 Integer.class 却声明为 Set<string></string> —— 这会导致编译警告，且运行时校验仍以你传入的 Class 参数为准。
checkedSet 拦截哪些操作
它会拦截所有可能引入非法类型的方法调用，包括：
-
add(E e)：插入单个元素前校验e.getClass() == elementType或是其子类 -
addAll(Collection extends E> c)：遍历c中每个元素逐一校验 -
contains(Object o)和remove(Object o)不校验类型（只读/查找不破坏类型安全）
关键限制与注意事项
这个包装器有明确边界，使用中需留意：
- 只对通过
checkedSet引用执行的操作生效；若还保留原始Set引用，绕过包装器插入非法类型将不被拦截 - 不支持泛型通配符校验，例如
Set extends Number>无法用checkedSet表达，只能指定具体类型如Number.class或Integer.class - 对 null 值不做特殊处理：如果
elementType允许 null（如引用类型），null 可正常插入；若 elementType 是基本类型包装类（如Integer.class），null 插入不会抛异常（因为 null 没有运行时类），但后续可能引发 NPE - 返回的 Set 是不可序列化的（即使底层集合可序列化），反序列化后会丢失类型检查能力
实际使用建议
适合在模块边界或 API 输出处加强契约保障：
- 对外提供集合时，用
checkedSet包装后再返回，防止调用方误塞错误类型 - 配合工厂方法封装，避免重复写
Collections.checkedSet(...) - 不要用于高频写入场景：每次插入都触发
getClass()反射调用，有轻微开销（通常可忽略）
