@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):
立即学习“Java免费学习笔记(深入)”;
@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 不是“创建”注解的步骤,而是让注解“活到你需要的时候”的关键配置。










