Java 注解（Annotation）

一、注解概述

​​​​​​​注解在我的理解下，就是代码中的特殊标记，这些标记可以在编译、类加载、运行时被读取，并执行相对应的处理。注解其实在开发中是非常常见的，比如我们在使用各种框架时 (像我们Java程序员接触最多的还是Spring框架一套)就会用到非常多的注解，@Controller /@Param / @Select 等等

官方介绍：

1.从 JDK 5.0 开始,Java 增加了对元数据(MetaData) 的支持,也就是Annotation(注解)

2.Annotation 其实就是代码里的特殊标记,这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。通过使用 Annotation,程序员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。

3.Annotation 可以像修饰符一样被使用,可用于修饰包,类,构造器方法,成员变量,参数,局部变量的声明,这些信息被保存在 Annotation的“name=value”对中。

二、自定义注解

如何自定义注解: 参照@SuppressWarnings定义

• 注解声明为: @interface

• 内部定义成员，通常使用value表示

• 可以指定成员的默认值，使用default 定义

• 如果自定义注解没有成员，表明是一个标识作用。

如果注解有成员，在使用注解时，需要指明成员的值，

自定义注解必须配上注解的才有意义

public @interface MyAnnotation {
    String value() default "hello";
}

三、JDK中的元注解

元注解：对现有的注解进行解释说明的注解

1.JDK的元Annotation 用于修饰其他Annotation定义

2.JDK5.0提供了4个标准的meta-annotation类型，分别是：

• Retention: 指定所修饰的 Annotation 的生命周期: SOURCE\CLASS (默认行为)\RUNTIME只有声明为RUNTIME生命周期的注解，才能通过反射获取。
• Target:用于指定被修饰的 Annotation 能用于修饰哪些程序元素
• Documented:表示所修饰的注解在被javadoc 解析时，保留下来
• Inherited: 被它修饰的 Annotation 将具有继承性

四、JDK8 注解的新特性

1 可重复注解:

在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class

MyAnnotation的Target和Retention等元注解和MyAnnotations相同。

2 类型注解:

ELementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中(如:泛型声明)

ELementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

五、扩展介绍

注解的生命周期@Retention注解传入的是RetentionPolicy枚举，该枚举有三个常量，分别是SOURCE、CLASS和RUNTIME，分别代表注解在编译期间、类加载期间、以及运行期间有效。所以重点来了，如果你想要在编译期间处理注解相关的逻辑，你需要继承AbstractProcessor 并实现process方法。比如可以看到Lombok就用AnnotationProcessor继承了AbstractProcessor。一般来说，只要自定义的注解中@Retention注解设置为SOURCE和CLASS这俩个级别，那么就需要继承并实现，因为SOURCE和CLASS这俩个级别等加载到jvm的时候，注解就被抹除了。