注解

什么是注解？

注解是JDK5引入的一种注释机制，Java语言中的类、构造器、方法、成员变量、参数等都可以被注解进行标注。

注解有什么用？

作用：对Java中类、方法、成员变量做标记，然后进行特殊处理，至于到底做何种处理由业务需求来决定。例如在JUnit框架中，标记了注解​​@Test​​的方法就可以被当成测试方法执行，而没有标记的就不能当成测试方法执行。

如何使用注解？

注解的使用时在注解名前加上@符号，并在其后的括号中对各元素复制，如

@myAnnoation(value = "a")
public void method(){
    //...
}

预定义的注解

Java提供了一些预定义的注解类型，如​​@Deprecated​​、​​@Override​​ 和 ​​@SuppressWarnings​​ 是在 ​​java.lang​​ 中预定义的。

​​@Deprecated​​ 注解表示标记的元素已被弃用，不应再使用。只要程序使用带 ​​@Deprecated​​ 注解的方法，类或字段，编译器就会生成警告。

​​@Override​​ 注解通知编译器该元素意图覆盖在超类中声明的元素。

​​@SuppressWarnings​​ 注解告诉编译器抑制它将会生成的特定警告。在以下示例中，使用了不推荐使用的方法，编译器通常会生成警告。但是，在这种情况下，注解会导致警告被抑制。

// 使用已弃用的方法，并告诉编译器产生警告
@SuppressWarnings("deprecation")
void DeprecatedMethod() {
   objectOne.deprecatedMethod();
}

元注解

元注解也是注解，作用是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它annotation类型作说明。Java5.0定义的元注解有以下几种：

1. ​​@Target​​:约束自定义注解只能在哪些地方使用
2. ​​@Retention​​:申明注解的生命周期
3. ​​@Documented​​:表明可以将注解通过javadoc或类似工具进行文档化
4. ​​@Inherited​​:表明注解被自动继承

​​@Target​​中可使用的值定义在​​ElementType​​枚举类中，常用值如下:

@Retention中可使用的值定义在​​RetentionPolicy​​枚举类中，常用值如下:

使用示例：

@Target({ElementType.FIELD, ElementType.METHOD})//规定使用范围--变量和方法
@Retention(RetentionPolicy.RUNTIME)//注解作用在源码阶段，字节码文件阶段，运行阶段
@interface MyTest {
    //自定义注解
}

自定义注解

public @interface 注解名称 {
    public 属性类型 属性名() default 默认值;//默认值可以省略
}//属性类型：Java支持的数据类型基本上都支持

特殊属性：value属性，如果只有一个value属性的情况下，使用value属性的时候可以省略value名称不写!!

但是如果有多个属性, 且多个属性没有默认值，那么value名称是不能省略的。

示例：

@MyBook(name = "《精通JavaSE》", authors = {"小米", "大头"}, price = 9.9)
public class Test {//测试类

    @MyBook(authors = "Ahaha")
    public void Main() {

    }
}

@interface MyBook {
    //public 属性类型 属性名() default 默认值
    String name() default "nobody";

    String[] authors();

    double price() default 999.999;
}

解析注解

注解的解析就是判断是否存在注解，存在注解就解析出内容。

与注解解析的相关的接口：

1. ​​Annotation​​:注解的顶级接口，注解都是Annotation类型的对象
2. ​​AnnotatedElement​​:该接口定义了与注解解析相关的解析方法，如下：

//获得当前对象上使用的所有注解，返回注解数组。
Annotation[] getDeclaredAnnotations();

//根据注解类型获得对应注解对象
T getDeclaredAnnotation(Class annotationClass);

//判断当前对象是否使用了指定的注解，如果使用了则返回true,否则false
boolean isAnnotationPresent(Class < Annotation> annotationClass)

所有的类成分Class、Method、Field、Constructor，都实现了​​AnnotatedElement​​接口，都拥有解析注解的能力。

解析一个注解，先获取注解对象（使用反射提供的API），再获取对象中的属性（使用注解提供的API）

1. 获取需要解析的对象
2. 判断当前对象是否使用了指定的注解 ​​isAnnotationPresent​​
3. 获取注解 ​​getDeclaredAnnotation​​、​​getDeclaredAnnotations​​