文章目录
简介
一、定义注解
元注解含义
(1)@Target
(2)@Retention
(3)@Documented
(4)@Inherited
(5)@Native
(6)@Repeatable
1. 元注解含义
从jdk1.5开始,在包java.lang.annotation下提供了四种元注解:@Target、@Retention、@Documented、@Inherited,java1.8后,annotation包下新提供了两种元注解:@Native、@Repeatable。自定义注解的时候需要使用元注解修饰,来看下各个元注解的使用说明
(1)@Target
标识注解可以使用的范围,例如使用在方法、字段、构造方法上
从源码中可以看出@Target只有一个属性value,属性类型为ElementType类型的数组,ElementType各个枚举值的作用范围如下:
①ElementType.TYPE:允许被修饰的注解作用在:类、接口、枚举上;
②ElementType.FIELD:允许被修饰的注解作用在:属性字段上;
③ElementType.METHOD:允许被修饰的注解作用在:方法上;
④ElementType.PARAMETER:允许被修饰的注解作用在:方法参数上;
⑤ElementType.CONSTRUCTOR:允许被修饰的注解作用在:构造器上;
⑥ElementType.LOCAL_VARIABLE:允许被修饰的注解作用在:本地局部变量上;
⑦ElementType.ANNOTATION_TYPE:允许被修饰的注解作用在:注解上;
⑧ElementType.PACKAGE:允许被修饰的注解作用在:包名上;
⑨ElementType.TYPE_PARAMETER:允许被修饰的注解作用在:类型参数上,jdk1.8提供;
⑩ElementType.TYPE_USE:允许被修饰的注解作用在:任何语句中(声明语句、泛型、强制转化),jdk1.8提供。
(2)@Retention
标识注解的生命周期
从源码可以看出@Retention只有一个属性value,属性类型为RetentionPolicy,看下RetentionPolicy枚举值的生命周期:
①RetentionPolicy.SOURCE:编译阶段丢弃,编译之后注解没有任何作用,不会写入字节码文件中。例如@Override、@SuppressWarnings、@Deprecated都属于这类注解;
②RetentionPolicy.CLASS:类加载阶段丢弃,类加载进jvm后没有任何作用,在字节码文件处理中有用。注解默认使用这种方式;
③RetentionPolicy.RUNTIME:始终不会丢弃,程序运行期也保留此注解,自定义注解通常使用这种方式,因此可以通过反射获取到注解配置的属性值。
(3)@Documented
标识注解是否在javadoc文档中显示
(4)@Inherited
标识注解是否能继承到子类
(5)@Native
标识字段是否可以被本地代码引用
(6)@Repeatable
标识可以重复使用注解
————————————————