Java @Retention 注解

在Java语言中，注解(Annotation)是一种元数据，可以帮助我们在Java代码中添加信息。@Retention 注解是一个元注解，用于标注注解的生命周期。

总的来说，@Retention 注解用于告诉编译器如何处理它所注释的注解。它有三个选项：RetentionPolicy.SOURCE、RetentionPolicy.CLASS 和 RetentionPolicy.RUNTIME。

RetentionPolicy.SOURCE

如果一个注解被设置为RetentionPolicy.SOURCE，那么这个注解只会存在于源代码中，编译时会被忽略掉。这个选项通常用于创建编译器警告或错误信息。例如，我们想要在自定义的注解中添加一些检查规则，当用户在代码中使用了这个注解但没有遵循特定规则时，编译器会发出一个警告。这样可以提醒用户在编译前解决问题，让代码更健壮。

以下是一个使用 @Retention(RetentionPolicy.SOURCE) 的注解实例：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.SOURCE)
public @interface ExampleAnnotation {
    int value();
}

RetentionPolicy.CLASS

如果一个注解被设置为RetentionPolicy.CLASS，那么这个注解会存储在编译后的 class 文件中，但是在运行时不会被加载到 JVM 中。这个选项通常用于字节码工具。例如，我们可以使用它来生成一些新的类，并在编译时将一些元数据存储在这些类中。

以下是一个使用 @Retention(RetentionPolicy.CLASS) 的注解实例：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.CLASS)
public @interface ExampleAnnotation {
    int value();
}

RetentionPolicy.RUNTIME

如果一个注解被设置为RetentionPolicy.RUNTIME，那么这个注解会存储在编译后的 class 文件中，并在运行时加载到 JVM 中。这个选项通常用于创建运行时检查或反射工具。例如，我们可以使用它来在代码运行时读取一些元数据，并根据这些元数据实现一些逻辑。

以下是一个使用 @Retention(RetentionPolicy.RUNTIME) 的注解实例：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface ExampleAnnotation {
    int value();
}

需要注意的是，如果想要在运行时使用反射来读取注解信息，必须使用 RetentionPolicy.RUNTIME，否则注解会被忽略。

在日常的开发工作中，@Retention 注解时常会被用到。掌握它可以帮助我们更好地理解Java代码中的元数据，让我们的代码更加灵活。