java Annotation 注解（转）

首先什么是注解？

　　最常见的是，在我们使用Eclipse等工具编写java代码的时候，有时候会出现一些比如@Deprecated，@Override，@SuppressWarnings等东东。这个就是常见的几种注解。

　　在开发Java程序，尤其是Java EE应用的时候，总是免不了与各种配置文件打交道。以Java EE中典型的S(pring)S(truts)H(ibernate)架构来说，Spring、Struts和Hibernate这三个框架都有自己的XML格式的配置文件。这些配置文件需要与Java源代码保存同步，否则的话就可能出现错误。而且这些错误有可能到了运行时刻才被发现。把同一份信息保存在两个地方，总是个坏的主意。理想的情况是在一个地方维护这些信息就好了。其它部分所需的信息则通过自动的方式来生成。JDK 5中引入了源代码中的注解（annotation）这一机制。注解使得Java源代码中不但可以包含功能性的实现代码，还可以添加元数据。注解的功能类似于代码中的注释，所不同的是注解不是提供代码功能的说明，而是实现程序功能的重要组成部分。Java注解已经在很多框架中得到了广泛的使用，用来简化程序中的配置。

　　而我们最常见的可能就是上面提到的这三个注解了，简单的介绍一下上面的这三个注解的作用：

　　  @Override:只能用在方法之上的，用来告诉别人这一个方法是改写父类的。 
  　　@Deprecated:建议别人不要使用旧的API的时候用的,编译的时候会用产生警告信息,可以设定在程序里的所有的元素上. 
        @SuppressWarnings:这一个类型可以来暂时把一些警告信息消息关闭. 

在jdk自带的java.lang.annotation包里,打开如下几个源文件:Target.java，Retention.java，RetentionPolicy.java，ElementType.java。

内容分别为：

?

@Documented  @Retention (RetentionPolicy.RUNTIME)   @Target (ElementType.ANNOTATION_TYPE)   public @interface Target {       ElementType[] value();   }

　　

?

@Documented  @Retention (RetentionPolicy.RUNTIME)   @Target (ElementType.ANNOTATION_TYPE)   public @interface Retention {       RetentionPolicy value();   }

　　

?

public enum RetentionPolicy {     SOURCE,     CLASS,     RUNTIME   }

　　

?

public enum ElementType {    TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR,    LOCAL_VARIABLE, ANNOTATION_TYPE,PACKAGE  }

　　在设计annotations的时候必须把一个类型定义为@interface。

     我们需要注意的是：SOURCE,CLASS 和 RUNTIME.这三个级别。

　　   SOURCE代表的是这个Annotation类型的信息只会保留在程序源码里，源码如果经过了编译之后，Annotation的数据就会消失,并不会保留在编译好的.class文件里面。 
         ClASS的意思是这个Annotation类型的信息保留在程序源码里,同时也会保留在编译好的.class文件里面,在执行的时候，并不会把这一些信息加载到虚拟机(JVM)中去.注意一下，当你没有设定一个Annotation类型的Retention值时，系统默认值是CLASS. 
         RUNTIME,表示在源码、编译好的.class文件中保留信息，在执行的时候会把这一些信息加载到JVM中去的．

　　  ＠Target里面的ElementType是用来指定Annotation类型可以用在哪一些元素上的.说明一下：TYPE(类型), FIELD(属性), METHOD(方法), PARAMETER(参数), CONSTRUCTOR(构造函数),LOCAL_VARIABLE(局部变量), ANNOTATION_TYPE,PACKAGE(包),其中的TYPE(类型)是指可以用在Class,Interface,Enum和Annotation类型上.
  　　 另外,@Target自己也用了自己来声明自己。如果一个Annotation类型没有指明@Target使用在哪些元素上,那么它可以使用在任何元素之上,这里的元素指的是上面的八种类型. 
   举几个正确的例子:

?

1 2 3

@Target (ElementType.METHOD)     @Target (value=ElementType.METHOD)     @Target (ElementType.METHOD,ElementType.CONSTRUCTOR)

　　@Documented的目的就是让这一个Annotation类型的信息能够显示在javaAPI说明文档上;没有添加的话，使用javadoc生成API文档的时候就会找不到这一个类型生成的信息.

　　另外一点，如果需要把Annotation的数据继承给子类，那么就会用到@Inherited这一个Annotation类型.

     本文只是简单的说了一下注解的常规用法，至于更加深入的注解学习，请参见文章末尾的参考资料。下面我们来看自定义一个注解：源代码有如下几个：

源码分别为：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

package com.java.annotation;   import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;   /**   * 类注解   * */ @Retention (RetentionPolicy.RUNTIME) @Target (ElementType.TYPE) public @interface MyAnnotationClass {      public String msg(); }

　　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

package com.java.annotation;   import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;   /**   * 方法注解   * */ @Retention (RetentionPolicy.RUNTIME) @Target (ElementType.METHOD) public @interface MyAnnotationMethod {      public String common(); }

　　

?

1 2 3 4 5 6 7 8 9 10 11 12

package com.java.annotation;   import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target;   @Retention (RetentionPolicy.RUNTIME) @Target (ElementType.FIELD) public @interface MyAnnotationField {      boolean request(); }

　　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

package com.java.annotation;   @MyAnnotationClass (msg = "这个是一个类注解" ) public class MyAnnotationDemo {        public MyAnnotationDemo() {      }        public MyAnnotationDemo(String hello) {          this .hello = hello;      }        @MyAnnotationMethod (common = "这个是一个方法注解" )      public void method() {          System.out.println(hello);      }        @MyAnnotationField (request = true )      private String hello; }

　　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

package com.java.annotation;   import java.lang.reflect.Field; import java.lang.reflect.Method;   public class MyAnnotationTest {      public static void main(String[] args) {          MyAnnotationDemo demo = new MyAnnotationDemo( "hello rollen" );          MyAnnotationClass annotationClass = demo.getClass().getAnnotation(MyAnnotationClass. class );          System.out.println(annotationClass.msg());            Method method = null ;          try {              method = demo.getClass().getMethod( "method" , new Class[ 0 ]);          } catch (SecurityException e) {              e.printStackTrace();          } catch (NoSuchMethodException e) {              e.printStackTrace();          }          MyAnnotationMethod annotationMethod = method.getAnnotation(MyAnnotationMethod. class );          System.out.println(annotationMethod.common());                    Field field = null ;          try {              field = demo.getClass().getDeclaredField( "hello" );          } catch (SecurityException e) {              e.printStackTrace();          } catch (NoSuchFieldException e) {              e.printStackTrace();          }          MyAnnotationField annotationField = field.getAnnotation(MyAnnotationField. class );          System.out.println(annotationField.request());        } }