Java基础@Retention如何创建注解?

@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 不是“创建”注解的步骤,而是让注解“活到你需要的时候”的关键配置。