@Retention
是一个 Java 注解,用于指定注解的保留策略,即注解的生命周期。该注解可以用于自定义注解上,指定该注解可以保留多长时间。
@Retention
注解包含一个 RetentionPolicy
类型的属性 value
,用于指定注解的保留策略,常用的保留策略包括:
RetentionPolicy.SOURCE
:表示注解仅在源代码中保留,编译器编译时会将其忽略,不会保存在编译后的字节码中。RetentionPolicy.CLASS
:表示注解在编译后的字节码中保留,但在运行时不会被加载到 JVM 中。这是默认的保留策略。RetentionPolicy.RUNTIME
:表示注解在编译后的字节码中保留,并在运行时被加载到 JVM 中。可以使用反射机制来访问该注解。
例如,以下代码定义了一个自定义注解 MyAnnotation
,使用 @Retention
注解指定该注解在运行时保留:
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
// ...
}
在上面的代码中,使用 @Retention(RetentionPolicy.RUNTIME)
指定 MyAnnotation
注解在运行时保留。在实际应用中,如果需要将 MyAnnotation
注解仅在编译期间保留,可以将 @Retention
注解的 value
属性设置为 RetentionPolicy.SOURCE
,即 @Retention(RetentionPolicy.SOURCE)
。