JDK中四个基本的元注解 [Java]

修饰现有的注解的注解我们就称之为元注解(meta - annotation)

也就是和元数据一样,我们将修饰现有的数据的数据称之为元数据(metaData) 下面就是jdk中四个基本的元注解 1. Retention

@Retention只能用于修饰注解,用于指定该注解的生命周期

@Retention元注解中包含了一个RetentionPolicy类型的成员变量(也就是配置参数),变量名为value

这里的RetentionPolicy是一个枚举类

使用@Retention时必须要为该声明为value的成员变量赋值,如果不赋值,则默认value值为RetentionPolicy.CLASS

而RetentionPolicy枚举类中的枚举值一共有如下三个:

RetentionPolicy.SOURCE

在源文件中有效,编译器直接会丢弃这种方式修饰的注解也称之为:“源文件保留”

RetentionPolicy.CLASS

在class文件中有效,当运行java程序时,JVM不会保留这种方式修饰的注解也称之为:“class保留”RetentionPolicy.CLASS是@Retention中的默认值

RetentionPolicy.RUNTIME

在程序运行时也有效,当运行java程序时,JVM会保留这种方式修饰的注解

注意: 修饰为这种方式的注解我们可以通过反射来获取到该注解

也称之为: “运行时保留”

当为运行时保留时我们就可以通过反射获取到被该元注解修饰的注解的信息

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-EyT3v5Pa-1644242288827)(E:非凡英才java笔记图解@Retention指明现有注解声明周期图解.png)]

@Target只能用于修饰现有的注解(Annotation),用于指定被修饰的注解的目标(也就是指明被修饰的注解可以修饰哪些程序元素)

@Target包含了一个ElementType[] 类型的成员变量,变量名为value

ElementType是一个枚举类

ElementType枚举类中的枚举值有以下7种 (jdk8.0之前)

注意: jdk8.0中又添加了两个枚举值(通过新添加的这两个枚举值从而实现了类型注解)

CONSTRUCTOR

用于修饰构造器

FIELD

用于修饰域(也就是属性(也就是成员变量))

LOAL_VARIABLE (variable 中文 变量)

用于修饰局部变量

METHOD

用于修饰方法

PACKAGE

用于修饰包

PARAMETER( parameter 中文 参数)

用于修饰参数

TYPE

用于修饰类,接口(包括注解类型,枚举类的声明

@documented只能用于修饰现有的注解

被@documented元注解修饰的注解将在被javadoc工具提取成文档时保留下来

默认情况下,Javadoc生成文档时不会保留注解的,除非此注解使用@documented元注解修饰 注意:使用@documented元注解修饰的注解的声明周期必须设置为"运行时保留",也就是必须设置@Retention的值为RetentionPolicy.RUNTIME 4. Inherited

@Inherited元注解只能用于修饰现有的注解

被@Inherited元注解修饰的注解将具有继承性

这里的具有继承性指的是: 如果某一个类使用了被@Inherited修饰的注解,那么其子类也将自动具有该注解

那么具体的我们如何验证其子类是否真正的继承了该注解,我们可以将这个注解的生命周期设置为"运行时保留",然后再通过反射去获得修饰子类的注解,然后去判断 总结：

定义注解通常都是指明两个元注解: Retention(声明周期)和Target(目标)

也就是在实际编程中,Retention和Target使用的比较多,而documented和Inherited则使用的比较少