注解可以描述为元数据,即一种描述数据的数据。其主要作⽤就是负责注解其他注解,为其他注解提供了相关的解释说明。元注解也是Java自带的标准注解,只不过用于修饰注解,比较特殊。
元注解包括@Retention、@Target、@Inherited、@Documented、@Repeatable 、@Native等。
元注解包括:
1. @Target注解
@Target注解的作用是:描述注解的使用范围(即被修饰的注解可以用在什么地方)。@Target注解用来说明那些被它注解的注解类可修饰的对象范围。
ElementType.TYPE:类、接⼝、注解、枚举
ElementType.FIELD:字段、枚举常量
ElementType.METHOD:⽅法
ElementType.PARAMETER:形式参数
ElementType.CONSTRUCTOR:构造⽅法
ElementType.LOCAL_VARIABLE:局部变量
ElementType.ANNOTATION_TYPE:注解
ElementType.PACKAGE:包
ElementType.TYPE_PARAMETER:类型参数
ElementType.TYPE_USE:类型使⽤
2. @Retention注解。
@Retention注解的作用是:描述注解保留的时间范围(即:被描述的注解在它所修饰的类中可以被保留到何时)。@Retention注解用来限定那些被它所注解的注解类在注解到其他类上以后,可被保留到何时。
RetentionPolicy.SOURCE:注解只保留在源码中,在编译时会被编译器丢弃
RetentionPolicy.CLASS:(默认的保留策略) 注解会被保留在Class⽂件中,但不会被加载到虚拟机中,运⾏时⽆法获得
RetentionPolicy.RUNTIME:注解会被保留在Class⽂件中,且会被加载到虚拟机中,可以在运⾏时获得
3. @Documented注解。
@Documented注解的作用是:描述在使用javadoc工具为类生成帮助文档时是否要保留其注解信息。 它是一个标记注解,没有成员。
4. @Inherited注解。
Inherited注解的作用是:使被它修饰的注解具有继承性(如果某个类使用了被@Inherited修饰的注解,则其子类将自动具有该注解。)
5. @Repeatable注解。
@Repeatable注解的作用是:用于声明标记的注解为可重复类型注解,可以在同一个地方多次使用。
声明可重复的注解,需要两个步骤:
(1)声明可重复的注解类型: @Listener注解
(2)声明包含的注解类型:@Listeners注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(Listeners.class)
public @interface Listener {
String value();
}
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Listeners {
Listener[] value();
}
6. @Native注解。
@Native注解修饰成员变量,则表示这个变量可以被本地代码引用,常常被代码生成工具使用。对于@Native注解不常使用,了解即可