指南:深度拆解 @RetentionPolicy 中 SOURCE、CLASS 与 RUNTIME 的断层区别

梦磊吖_6172

梦磊吖_6172

2026-05-30

207人浏览

原创

选错@retention策略会导致注解在目标阶段不可见:source仅存于源码,编译后消失;class保留在字节码但反射不可见;runtime是唯一支持反射的策略,三者间无隐式升级。

指南:深度拆解 @retentionpolicy 中 source、class 与 runtime 的断层区别

选错 @Retention 策略,注解就“看不见”——不是代码写错了,而是生命周期根本没走到那一步。SOURCE、CLASS、RUNTIME 不是简单的“保留时间长短”,而是作用域的硬性断层:每个策略对应一个不可跨越的阶段边界,跨阶段访问必然失败。

SOURCE:只活在.java文件里,编译完就清零

注解仅存在于源码阶段,javac 编译时直接丢弃,字节码中完全不存在。它不参与后续任何环节,连.class文件都搜不到痕迹。

  • 适用场景:纯编译期检查或代码生成,比如 @Override、@SuppressWarnings、Lombok 的 @Getter
  • 关键判断:如果你不需要在编译后做任何事(不读取、不增强、不反射),就用 SOURCE
  • 常见误用:想用注解驱动构建流程却设为 SOURCE——构建工具根本看不到它

CLASS:进得了.class,进不了JVM内存

注解被写入字节码文件,可通过二进制工具(如 javap)查看,但 JVM 加载类时不会将其加载进运行时元数据。反射调用 getAnnotation() 或 isAnnotationPresent() 必定返回 null 或 false。

  • 适用场景:需要在编译后、运行前介入的流程,例如 APT(Annotation Processing Tool)、字节码增强工具(如某些 AOP 框架预处理)、构建时校验
  • 关键判断:你依赖的是构建工具或字节码操作库(如 ASM、Byte Buddy),而不是 Java 反射
  • 典型信号:IDE 提示 “Annotation is not retained for reflective access” 就是 CLASS 策略的明确标识

RUNTIME:唯一能被反射捕获的注解生命态

注解完整保留在 JVM 运行时的类元数据中,只有 RUNTIME 才支持 Class.getAnnotation()、Method.isAnnotationPresent() 等反射操作。Spring 的 @Autowired、JUnit 的 @Test、自定义定时任务注解都必须走这条路。

  • 适用场景:框架动态行为、运行时配置注入、AOP 切面织入、序列化策略控制
  • 关键代价:带来额外的内存占用与类加载开销;若注解高频存在且无需运行时访问,应避免滥用 RUNTIME
  • 硬性要求:只要反射逻辑存在,注解声明中 @Retention(RetentionPolicy.RUNTIME) 就不可省略或替换

三个策略之间没有隐式升级路径。设成 CLASS,不会因为“我后面想反射”就自动变成 RUNTIME;设成 SOURCE,也不会因为“构建工具想扫它”就突然出现在字节码里。断层就是断层,越界即失效。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

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

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10477

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7602

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6652

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1376

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2749

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20071

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1215

8

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习