学习笔记:JAVA元注解
jdk1.5起开始提供了4个元注解,用来定义自定义注解的注解,它们分别是:
@Target:指定注解使用的目标范围(类、方法、字段等),当注解类型声明中没有 @Target元注解,则默认为可适用所有的程序元素。如果存在指定的 @Target元注解,则编译器强制实施相应的使用限制。关于程序元素(ElementType)是枚举类型,共定义8种程序元素,如下:
ElementType 含义
ANNOTATION_TYPE: 注解类型声明
CONSTRUCTOR: 构造方法声明
FIELD: 字段声明(包括枚举常量)
LOCAL_VARIABLE: 局部变量声明
METHOD: 方法声明
PACKAGE: 包声明
PARAMETER: 参数声明
TYPE: 类、接口(包括注解类型)或枚举声明
例如,上面源码@Target的定义中有一行 @Target(ElementType.ANNOTATION_TYPE),意思是指当前注解的元素类型是注解类型。
@Documented指定被标注的注解会包含在javadoc中。
@Retention指定注解的生命周期(源码、class文件、运行时),当注解类型声明中没有@Retention元注解,则默认保留策略为RetentionPolicy.CLASS。关于保留策略(RetentionPolicy)是枚举类型,共定义3种保留策略,如下:
RetentionPolicy 含义
SOURCE: 仅存在Java源文件,经过编译器后便丢弃相应的注解
CLASS: 存在Java源文件,以及经编译器后生成的Class字节码文件,但在运行时VM不再保留注释
RUNTIME: 存在源文件、编译生成的Class字节码文件,以及保留在运行时VM中,可通过反射性地读取注解
@Inherited: 指定子类可以继承父类的注解,只能是类上的注解,方法和字段的注解不能继承。
即如果父类上的注解是 @Inherited修饰的就能被子类继承。
jdk1.8又提供了以下两个元注解
@Native指定字段是一个常量,其值引用native code。
@Repeatable注解上可以使用重复注解,即可以在一个地方可以重复使用同一个注解,像spring中的包扫描注解就使用了这个。