注解概述

  1. jdk 5.0 新增的功能。
  2. Annotation 其实就是代码里的特殊标记，这些标记可以在编译、类加载、 运行时被读取， 并执行相应的处理。通过使用 Annotation，程序员可以在不改变原有逻辑的情况下， 在源文件中嵌入一些补充信息。
  3. Annotation可以像修饰符一样被使用， 可用于修饰包、类、构造器、方法、成员变量、参数、局部变量的声明， 这些信息被保存在 Annotation 的 “name=value” 对中。
  4. 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等。
  5. 未来的开发模式都是基于注解的，JPA是基于注解的，Spring2.5以上都是基于注解的，Hibernate3.x以后也是基于注解的，现在的 Struts2有一部分也是基于注解的了，注解是一种趋势，一定程度上可以说：框架 = 注解 + 反射 + 设计模式。
  6. 使用 Annotation 时要在其前面增加 @ 符号，并把该 Annotation当成一个修饰符使用，用于修饰它支持的程序元素。

Annocation的使用示例

  • 示例一：生成文档相关的注解。

image.png

  • 示例二：在编译时进行格式检查(JDK内置的三个基本注解)。
    @Override: 限定重写父类方法， 该注解只能用于方法。 ```java interface Info{ void show(); }

class Student extends Person implements Info{

  1. @Override
  2. public void walk() {
  3.     System.out.println("学生走路");
  4. }
  6. public void show() {
  8. }

}

@Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择。<br />@SuppressWarnings: 抑制编译器警告。

- 示例三：跟踪代码依赖性，实现替代配置文件功能。

![image.png](https://cdn.nlark.com/yuque/0/2022/png/1534487/1657718049658-ce962d6d-0b3d-4771-b7ff-efba2b151829.png#clientId=ua4709ef7-871b-4&crop=0&crop=0&crop=1&crop=1&from=paste&height=785&id=u2344e622&margin=%5Bobject%20Object%5D&name=image.png&originHeight=864&originWidth=1866&originalType=binary&ratio=1&rotation=0&showTitle=false&size=264071&status=done&style=none&taskId=u42566d15-b7fd-47af-a632-b66788bd420&title=&width=1696.3635995959455)

---

<a name="elwip"></a>
## 自定义注解
参照@SuppressWarnings定义。

1. 注解声明为：@interface。
1. 内部定义成员，通常使用value表示。
1. 可以指定成员的默认值，使用default定义。
1. 如果自定义注解没有成员，表明是一个标识作用。
```java
public @interface MyAnnotation {

    String value() default "hello";
}

如果注解有成员，在使用注解时，需要指明成员的值。
自定义注解必须配上注解的信息处理流程(使用反射)才有意义。

jdk5.0中的元注解

元注解：对现有的注解进行解释说明的注解，其实就是“注解的注解”。
自定义注解通常都会指明两个元注解：Retention、Target。

  1. Retention：指定所修饰的 Annotation 的生命周期：SOURCE\CLASS（默认行为）\RUNTIME。
    1. SOURCE：在源文件中有效（即源文件保留），编译器直接丢弃这种策略的注释。
    2. CLASS：在class文件中有效（即class保留）， 当运行 Java 程序时，JVM不会保留注解（默认值）。
    3. RUNTIME：在运行时有效（即运行时保留），当运行 Java 程序时，JVM会保留注释。程序可以通过反射获取该注释。

image.png

  1. Target：用于指定被修饰的 Annotation 能用于修饰哪些程序元素。

image.png

  1. Documented：表示所修饰的注解在被javadoc解析时，保留下来（出现的频率较低）。
  2. Inherited：被它修饰的 Annotation 将具有继承性（出现的频率较低）。

jdk8 中注解的新特性

  1. 可重复注解：
    1. 在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class。
    2. MyAnnotation的Target和Retention等元注解与MyAnnotations相同。
  2. 类型注解：
    1. ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
    2. ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。