java注解详解

Annotation(注解)是JDK5.0及以后版本引入的一个特性。注解是java的一个新的类型（与接口很相似），它与类、接口、枚举是在同一个层次，它们都称作为java的一个类型（TYPE）。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。它的作用非常的多，例如:

进行编译检查、生成说明文档、代码分析等。

JDK 提供的注解

         a.@SuppressWarnings

该注解的作用是阻止编译器发出某些警告信息。

   它可以有以下参数:

            deprecation：过时的类或方法警告。

            unchecked：执行了未检查的转换时警告。

            fallthrough：当Switch程序块直接通往下一种情况而没有Break时的警告。

            path：在类路径、源文件路径等中有不存在的路径时的警告。

            serial：当在可序列化的类上缺少serialVersionUID定义时的警告。

            finally：任何finally子句不能完成时的警告。

   all：关于以上所有情况的警告。

b.@Deprecated

   该注解的作用是标记某个过时的类或方法。

c.@Override

   该注解用在方法前面，用来标识该方法是重写父类的某个方法。

元注解

         a.@Retention

                  它是被定义在一个注解类的前面，用来说明该注解的生命周期。

                  它有以下参数：

                  RetentionPolicy.SOURCE：指定注解只保留在一个源文件当中。

                  RetentionPolicy.CLASS：指定注解只保留在一个class文件中。

                  RetentionPolicy.RUNTIME：指定注解可以保留在程序运行期间。

         b.@Target

                  它是被定义在一个注解类的前面，用来说明该注解可以被声明在哪些元素前。

                  它有以下参数：

                  ElementType.TYPE：说明该注解只能被声明在一个类前。

                  ElementType.FIELD：说明该注解只能被声明在一个类的字段前。

                  ElementType.METHOD：说明该注解只能被声明在一个类的方法前。

                  ElementType.PARAMETER：说明该注解只能被声明在一个方法参数前。  

ElementType.CONSTRUCTOR：说明该注解只能声明在一个类的构造方法前。

                  ElementType.LOCAL_VARIABLE：说明该注解只能声明在一个局部变量前。

                  ElementType.ANNOTATION_TYPE：说明该注解只能声明在一个注解类型前。

                  ElementType.PACKAGE：说明该注解只能声明在一个包名前。

注解的生命周期

一个注解可以有三个生命周期，它默认的生命周期是保留在一个CLASS文件，但它也可

以由一个@Retetion的元注解指定它的生命周期。

         a.java源文件

           当在一个注解类前定义了一个@Retetion(RetentionPolicy.SOURCE)的注解，那么说

           明该注解只保留在一个源文件当中，当编译器将源文件编译成class文件时，它不

           会将源文件中定义的注解保留在class文件中。

         b.class文件中

           当在一个注解类前定义了一个@Retetion(RetentionPolicy.CLASS)的注解，那么说

           明该注解只保留在一个class文件当中，当加载class文件到内存时，虚拟机会将注

           解去掉，从而在程序中不能访问。

         c.程序运行期间

           当在一个注解类前定义了一个@Retetion(RetentionPolicy.RUNTIME)的注解，那么

           说明该注解在程序运行期间都会存在内存当中。此时，我们可以通过反射来获得

           定义在某个类上的所有注解。

注解的定义

         public@interface Annotation01{

                   //定义公共的final静态属性

                   .....

                   //定以公共的抽象方法

                   ......

         }

         a.注解可以有哪些成员

                   注解和接口相似，它只能定义final静态属性和公共抽象方法。

         b.注解的方法

                   1.方法前默认会加上publicabstract

                   2.在声明方法时可以定义方法的默认返回值。

                   例如:

                   Stringcolor()default"blue";

                   String[]color()default{"blue","red",......}

                   3.方法的返回值可以有哪些类型

                   8种基本类型，String、Class、枚举、注解及这些类型的数组。

         c.使用注解（参照下面的注解使用）

注解的使用分为三个过程。

         定义注解-->声明注解-->得到注解

         a.定义注解（参照上面的注解定义）

         b.声明注解

                   1.在哪些元素上声明注解

                   如果定义注解时没有指定@Target元注解来限制它的使用范围，那么该注

                   解可以使用在ElementType枚举指定的任何一个元素前。否则，只能声明在

                   @Target元注解指定的元素前。

                   一般形式：

                   @注解名()

                   2.对注解的方法的返回值进行赋值

                   对于注解中定义的每一个没有默认返回值的方法，在声明注解时必须对它

                   的每一个方法的返回值进行赋值。

                   一般形式:

                   @注解名(方法名=方法返回值，、、、、、、)

                   如果方法返回的是一个数组时，那么将方法返回值写在{}符号里

                   @注解名(方法名={返回值1，返回值2，、、、、、、}，、、、、、、、)

                   3.对于只含有value方法的注解，在声明注解时可以只写返回值。

         c.得到注解

                   对于生命周期为运行期间的注解，都可以通过反射获得该元素上的注解实例。1

                   、声明在一个类中的注解

                   可以通过该类Class对象的getAnnotation或getAnnotations方法获得。

                   2、声明在一个字段中的注解

                   通过Field对象的getAnnotation或getAnnotations方法获得

                   3、声明在一个方法中的注解

                   通过Method对象的getAnnotation或getAnnotations方法获得

注解可以看成是一个接口，注解实例就是一个实现了该接口的动态代理类。

注解大多是用做对某个类、方法、字段进行说明，标识的。以便在程序运行期间我们通

过反射获得该字段或方法的注解的实例，来决定该做些什么处理或不该进行什么处理。