JAVA注解详解(@Target,@Documented,@Retention,@Inherited,@Native,@Repeatable)

Posted 2023-02-15 WSYW126

jdk1.5起开始提供了4个元注解，用来定义自定义注解的注解，它们分别是：

@Target:注解的作用目标

@Target(ElementType.TYPE)——接口、类、枚举、注解
@Target(ElementType.FIELD)——字段、枚举的常量
@Target(ElementType.METHOD)——方法
@Target(ElementType.PARAMETER)——方法参数
@Target(ElementType.CONSTRUCTOR) ——构造函数
@Target(ElementType.LOCAL_VARIABLE)——局部变量
@Target(ElementType.ANNOTATION_TYPE)——注解
@Target(ElementType.PACKAGE)——包

@Retention：(保留)注解说明,这种类型的注解会被保留到那个阶段.

有三个值:
RetentionPolicy.SOURCE:这种类型的Annotations只在源代码级别保留,编译时就会被忽略,在class字节码文件中不包含。
RetentionPolicy.CLASS:这种类型的Annotations编译时被保留,默认的保留策略,在class文件中存在,但JVM将会忽略,运行时无法获得。
RetentionPolicy.RUNTIME:这种类型的Annotations将被JVM保留,所以他们能在运行时被JVM或其他使用反射机制的代码所读取和使用。


@Document：说明该注解将被包含在javadoc中

Documented 注解表明这个注解应该被 javadoc工具记录. 默认情况下,javadoc是不包括注解的. 但如果声明注解时指定了 @Documented,则它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中.


@Inherited

说明子类可以继承父类中的该注解

 

jdk1.8又提供了以下两个元注解

@Native

指定字段是一个常量，其值引用native code。

@Repeatable

注解上可以使用重复注解，即可以在一个地方可以重复使用同一个注解，像spring中的包扫描注解就使用了这个。

注意事项(一些约束)

• @Repeatable 所声明的注解，其元注解@Target的使用范围要比@Repeatable的值声明的注解中的@Target的范围要大或相同，否则编译器错误，显示@Repeatable值所声明的注解的元注解@Target不是@Repeatable声明的注解的@Target的子集
• @Repeatable注解声明的注解的元注解@Retention的周期要比@Repeatable的值指向的注解的@Retention得周期要小或相同。
  • 周期长度为 SOURCE(源码) < CLASS (字节码) < RUNTIME(运行)

转载请注明出处：https://blog.csdn.net/WSYW126/article/details/105848871
作者：WSYW126