@Retention注解用于定义注解的生命周期,是Java中创建自定义注解的重要部分。它决定了注解在什么阶段有效,例如在源代码中、编译时或运行时。以下是使用 @
@Retention是Java中指定注解保留策略的元注解,不创建注解而控制其生命周期:SOURCE(仅源码)、CLASS(默认,.class中但运行时不可见)、RUNTIME(.class中且反射可读)。
@Retention是Java中指定注解保留策略的元注解,不创建注解而控制其生命周期:SOURCE(仅源码)、CLASS(默认,.class中但运行时不可见)、RUNTIME(.class中且反射可读)。

@Retention 是 Java 中用来指定注解保留策略的元注解,它**不负责创建注解本身**,而是控制你自定义的注解在什么阶段还“有效”——比如编译期、运行时,还是仅在源码中存在。
先创建一个注解(用 interface + @interface)
Java 注解本质是一个特殊的接口,用 @interface 声明:
public @interface MyLog {
String value() default "log";
int level() default 1;
}
这样就定义了一个带两个属性的注解 @MyLog。但此时它默认只保留在源码阶段(RetentionPolicy.SOURCE),运行时 getAnnotation() 拿不到。
用 @Retention 指定注解生命周期
要在运行时通过反射获取该注解,必须显式加上 @Retention(RetentionPolicy.RUNTIME):
@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {
String value() default "log";
int level() default 1;
}
常用保留策略有三个:
- SOURCE:只保留在源代码中,编译后丢弃(如
@Override) - CLASS:保留在 .class 文件中,但运行时不可见(默认值)
- RUNTIME:保留在 .class 中且可通过反射读取(写框架、AOP、ORM 时必需)
搭配 @Target 明确使用位置(推荐一起用)
单独用 @Retention 不够,你还得告诉编译器这个注解能加在哪儿,比如类、方法、参数等:
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface MyLog { ... }
常见 ElementType 值:
TYPE→ 类、接口、枚举METHOD→ 方法FIELD→ 成员变量PARAMETER→ 方法参数LOCAL_VARIABLE→ 局部变量(很少用)
验证注解是否生效(运行时反射)
加了 @Retention(RUNTIME) 后,就能在运行时读取:
@MyLog(level = 2)
public class UserService {
@MyLog("update user")
public void update() { ... }
}
// 反射获取
MyLog anno = UserService.class.getAnnotation(MyLog.class);
System.out.println(anno.level()); // 输出 2
如果没加 @Retention(RUNTIME),这里会返回 null。
基本上就这些。@Retention 不是“创建”注解的步骤,而是让注解“活到你需要的时候”的关键配置。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。















