Annotation介绍

boy.gan

于 2015-12-29 13:49:36 发布

阅读量289

点赞数

分类专栏： java

java 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

Annotation是继承自 java.lang.annotation.Annotation 的类,用于向程序分析工具或虚拟机提供package class field methed 等方面的信息,它和其他类没什么区别,除了使用方式.

Annotation的一般形式是 :

[java]view plaincopyprint? 
   
 public @interface MyAnnotation {     
     String value() default "hahaha";     
 }    

我认为和它等价的java类为:

[java]view plaincopyprint? 
   
 public class MyAnnotation extends java.lang.annotation.Annotation{     
      private String value = "hahaha";     
      public void setValue(String value){     
           this.value = value;     
      }     
      public String getValue(){     
           return value;     
       }     
 }    

Annotation的使用方法和Bean的比较:

[java]view plaincopyprint? 
   
 @MyAnnotation(value="hello")     //对应Bean的set方法     
     
 Method method = AnnotationTest.class.getMethod("doSomthing", null);   //取得被注释的方法,AnnotationTest.class为该方法所在的类     
 MyRetention mr = method.getAnnotation(MyRetention.class); //取得注释对象     
 String value = mr.value();    //取得value的值,对应Bean的get方法.    

@interface实际上是继承了java.lang.annotation.Annotation,所以定义annotation时不能继承其他annotation或interface.
java.lang.annotation.Retention告诉编译器如何对待 Annotation,使用Retention时,需要提供java.lang.annotation.RetentionPolicy的枚举值.

[java]view plaincopyprint? 
   
 public enum RetentionPolicy {     
     SOURCE, // 编译器处理完Annotation后不存储在class中     
     CLASS, // 编译器把Annotation存储在class中，这是默认值     
     RUNTIME // 编译器把Annotation存储在class中，可以由虚拟机读取,反射需要     
 }     

java.lang.annotation.Target告诉编译器Annotation使用在哪些地方,使用需要指定java.lang.annotation.ElementType的枚举值.

[java]view plaincopyprint? 
   
 public enum ElementType {     
     TYPE, // 指定适用点为 class, interface, enum     
     FIELD, // 指定适用点为 field     
     METHOD, // 指定适用点为 method     
     PARAMETER, // 指定适用点为 method 的 parameter     
     CONSTRUCTOR, // 指定适用点为 constructor     
     LOCAL_VARIABLE, // 指定使用点为 局部变量     
     ANNOTATION_TYPE, //指定适用点为 annotation 类型     
     PACKAGE // 指定适用点为 package     
 }     

java.lang.annotation.Documented用于指定该Annotation是否可以写入javadoc中.
java.lang.annotation.Inherited用于指定该Annotation用于父类时是否能够被子类继承.
如

[java]view plaincopyprint? 
   
 import java.lang.annotation.ElementType;     
 import java.lang.annotation.Retention;     
 import java.lang.annotation.RetentionPolicy;     
 import java.lang.annotation.Target;     
     
 @Documented  //这个Annotation可以被写入javadoc     
 @Inherited       //这个Annotation 可以被继承     
 @Target({ElementType.CONSTRUCTOR,ElementType.METHOD}) //表示这个Annotation只能用于注释 构造子和方法     
 @Retention(RetentionPolicy.CLASS) //表示这个Annotation存入class但vm不读取     
 public @interface MyAnnotation {     
     String value() default "hahaha";     
 }    

java.lang.reflect.AnnotatedElement接口提供了四个方法来访问Annotation

[java]view plaincopyprint? 
   
 public Annotation getAnnotation(Class annotationType);     
 public Annotation[] getAnnotations();     
 public Annotation[] getDeclaredAnnotations();     
 public boolean isAnnotationPresent(Class annotationType);   

Class、Constructor、Field、Method、Package等都实现了该接口,可以通过这些方法访问Annotation信息,前提是要访问的Annotation指定Retention为RUNTIME.

    Java内置的annotation有Override Deprecated SuppressWarnings.
    Override只用于方法,它指明注释的方法重写父类的方法,如果不是,则编译器报错.
    Deprecated指明该方法不建议使用
    SuppressWarnings告诉编译器:我知道我的代码没问题,你不用吓我了,我不怕的^_^
    这些都是Mark Annotation,名称本身就包含了要提供的信息,不需要额外提供.
转自： http://www.javaeye.com/topic/171412