注解

什么是注解？

注解是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定义的元注解有以下几种：

​​@Target​​:约束自定义注解只能在哪些地方使用

​​@Retention​​:申明注解的生命周期

​​@Documented​​:表明可以将注解通过javadoc或类似工具进行文档化

​​@Inherited​​:表明注解被自动继承

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

可选值

使用范围

TYPE

类，接口

FIELD

成员变量

METHOD

成员方法

PARAMETER

方法参数

CONSTRUCTOR

构造器

LOCAL_VARIABLE

局部变量

PACKAGE

包

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

SOURCE

注解只作用在源码阶段，生成的字节码文件中不存在

CLASS

注解作用在源码阶段，字节码文件阶段,运行阶段不存在，默认值

RUNTIME

注解作用在源码阶段，字节码文件阶段，运行阶段(开发常用)

使用示例：

@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;}

解析注解

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

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

​​Annotation​​:注解的顶级接口，注解都是Annotation类型的对象

​​AnnotatedElement​​:该接口定义了与注解解析相关的解析方法，如下：

//获得当前对象上使用的所有注解，返回注解数组。Annotation[] getDeclaredAnnotations();//根据注解类型获得对应注解对象T getDeclaredAnnotation(Class<T> annotationClass);//判断当前对象是否使用了指定的注解，如果使用了则返回true,否则falseboolean isAnnotationPresent(Class < Annotation> annotationClass)

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

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

获取需要解析的对象

判断当前对象是否使用了指定的注解 ​​isAnnotationPresent​​

获取注解 ​​getDeclaredAnnotation​​、​​getDeclaredAnnotations​​