讲师中心 微信公众号
AI工具推荐 视频效率加速

如何使用Collections.checkedList_在运行时捕捉泛型类型违规

小雪同学_6598

小雪同学_6598

发布时间:2026-02-20 10:30:58

|

399人浏览过

|

来源于php中文网

原创

Collections.checkedList 仅在运行时写入操作(add/set/addAll)时检查类型,声明、读取、转型、toArray、stream 等均不检查;不校验初始列表内容,也不拦截 get 后强转失败。

如何使用collections.checkedlist_在运行时捕捉泛型类型违规

为什么 Collections.checkedList 看起来没起作用?

它确实能捕获泛型违规,但只在「运行时写入」时检查——声明时、读取时、转型时都不报错。很多人误以为加了 checkedList 就像编译器一样全程盯防,结果往里塞错类型后,直到调用 add、set 或 addAll 才抛 ClassCastException。

常见错误现象:List<string> list = Collections.checkedList(new ArrayList(), String.class); list.add(123); // 运行时报错:ClassCastException: Integer cannot be cast to String</string>

  • 它不检查构造后的原始列表内容(比如你传入一个已混入 Integer 的 ArrayList)
  • 不拦截 get() 返回值的后续使用(返回 Object 后强转失败是你的事)
  • 对 toArray()、stream() 等间接操作无防护

Collections.checkedList 和 ArrayList 直接泛型的区别

直接声明 List<string> list = new ArrayList();</string> 是纯编译期约束,擦除后完全没运行时保护;而 checkedList 是运行时守门员,靠包装代理实现检查。

  • 性能开销:每次写操作多一次 instanceof 判断,高频写场景可感知(如循环 add 万级元素)
  • 兼容性:返回的是 CheckedList(私有静态类),不是 ArrayList,不能强转或依赖其特有方法
  • 泛型擦除后行为一致:两者在反射或序列化时都丢失类型信息,checkedList 不改变这点

哪些操作会触发类型检查?

只对明确修改元素内容的方法生效,且检查目标是「要写入的值」是否匹配泛型类型参数。

  • 触发检查:add(E)、set(int, E)、addAll(Collection extends E>)、add(int, E)
  • 不触发检查:get(int)、size()、isEmpty()、contains(Object)(注意:这里 Object 是任意类型,不会校验)、iterator().next()
  • 特殊:如果用 list.set(0, null),只要泛型类型允许 null(即非基本类型包装类),就不会报错

容易被忽略的坑:包装的是视图,不是数据源头

checkedList 返回的是原列表的带检查包装器,不是拷贝。如果你保留了对底层列表的引用,绕过包装器直接操作,所有检查就失效了。

示例:

List raw = new ArrayList();
List<String> checked = Collections.checkedList(raw, String.class);
raw.add(42); // 完全不报错!checked.get(0) 取出来再强转才崩

  • 永远不要暴露原始列表引用
  • 避免和 Arrays.asList() 混用(后者返回不可扩容列表,checkedList 包装后 add 仍会抛 UnsupportedOperationException)
  • 注意线程安全:它不提供同步,多线程写需额外加锁

真正难防的不是写错类型,而是有人绕过包装器、或在检查边界外做类型转换——这时候泛型安全就只剩一层纸。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7259

2023.08.02

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7259

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3465

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

4548

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

3045

2025.08.29

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4476

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

326

2025.12.06

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

411

2026.03.13

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn