在 Java 中,有四个重要的元注解,它们分别是 @Retention
、@Target
、@Inherited
和 @Documented
,它们用于对自定义注解进行修饰和说明。
元注解是用于定义注解的注解
-
@Retention
:@Retention
用于指定注解的保留策略,即注解在代码运行时的生命周期。它接受一个RetentionPolicy
类型的参数,包括三个选项:RetentionPolicy.SOURCE
、RetentionPolicy.CLASS
和RetentionPolicy.RUNTIME
。其中,RetentionPolicy.SOURCE
表示该注解仅存在于源代码中,在编译后不会保留;RetentionPolicy.CLASS
表示该注解会被保留到编译后的字节码文件中,但在运行时无法获取;RetentionPolicy.RUNTIME
表示该注解会被保留到运行时,并且可以通过反射机制获取注解信息。 -
@Target
:@Target
用于指定注解可以应用的目标元素类型。它接受一个ElementType
类型的数组参数,包括多个选项:ElementType.TYPE
(类、接口、枚举)、ElementType.FIELD
(字段)、ElementType.METHOD
(方法)、ElementType.PARAMETER
(方法参数)、ElementType.CONSTRUCTOR
(构造函数)、ElementType.LOCAL_VARIABLE
(局部变量)等。通过@Target
可以限制注解的使用范围,使其只能应用于特定的元素类型。 -
@Inherited
:@Inherited
用于指定注解是否具有继承性。当一个注解被@Inherited
修饰后,它会被子类所继承。默认情况下,注解是不具有继承性的,即子类不会继承父类的注解。 -
@Documented
:@Documented
用于指定注解是否包含在 Java 文档中。当一个注解被@Documented
修饰后,它将被包含在生成的文档中,方便开发人员查阅。
这四个元注解分别用于修饰和说明自定义注解的保留策略、适用范围、继承性和文档化情况,通过使用它们可以对自定义注解进行更精细的控制和说明。