Java-注解（Annotation）——详细笔记

一、概述

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

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

在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等。

未来的开发模式都是基于注解的，JPA是基于注解的，Spring2.5以上都是基于注解的，Hibernate3.x以后也是基于注解的，现在的Struts2有一部分也是基于注解的了，注解是一种趋势，一定程度上可以说：框架 = 注解 + 反射 + 设计模式。

二、注解的使用规范和场景

使用Annotation时要在前面增加@符号，并把该Annotation当作一个修饰符使用。用于修饰它支持的程序元素。

1、示例一：生成文档相关的注解

2、示例二：在编译时进行格式检查（JDK内置的三个基本注解）

@Override： 限定重写父类方法，该注解只能用于方法。

@Deprecated： 用于表示所修饰的元素（类、方法等）已过时。通常是因为所修饰的结构危险或存在更好的选择。

@SuppressWarning： 抑制编译器警告。

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

①Servlet3.0提供了注解（Annotation），使得不再需要在web.xml文件中进行Servlet的部署。

②Spring框架中关于“事务”的管理

三、自定义注解类（少用到）

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

【
注意：
1.如果注解有成员，在使用注解时，需要指明成员的值。
2.自定义注解必须配上注解的信息处理流程（使用反射）才有意义。
3.自定义注解通常会指明两个元注解：Retention、Target。
】

创建自定义注解：

public @interface MyAnnotation {
    String value();
}

使用自定义注解：

	如果注解有成员，在使用注解时，需要指明成员的值。
    @MyAnnotation(value = "hi~")
    public void tryAnnotation(){
        System.out.println("hello");
    }

更多需要注意的：

四、JDK提供的4种元注解

概念： JDK的元Annotation用于修饰其他Annotation定义。（人话：对现有的注解进行解释说明的注解。）

JDK5.0提供了4个标准的meta-annotation类型：

• Retention
• Target
• Document
• Inherited

1、Retention

概念： 指定所修饰的Annotation的生命周期：

• SOURCE
• CLASS（默认行为）
• RUNTIME（只有声明为RUNTIME生命周期的注解，才能通过反射获取）
  

2、Target

概念： 用于指定被修饰的Annotation能用于修饰哪些程序元素。

• TYPE
• FIELD
• METHOD
• PARAMETER
• CONSTRUCTOR
• LOCAL_VARIABLE
• ANNOTATION_TYPE
• PACKAGE
• TYPE_PARAMETER
• TYPE_USE

/以下为低出现频率的元注解/

3、Document 和 Inherited

Document 概念： 表示所修饰的注解在被javadoc解析时，保留下来。

Inherited 概念： 被它修饰的Annotation将具有继承性。

五、JDK 8 注解的新特性

1、可重复注解

示例步骤（重点）：

1. 在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class 。
2. MyAnnotation的（Target和Retention等元注解）必须和MyAnnotation相同。

MyAnnotation：

@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value();
}

MyAnnotations：

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations {
    MyAnnotation[] value();
}

然后就可以使用重复注解了：

   	@MyAnnotation(value = "hi~")
    @MyAnnotation(value = "abc")
    public void tryAnnotation(){
        System.out.println("hello");
    }

2、类型注解

• ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
• ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。