Annotation(注解),Annotation是代码里的特殊标记,这些标记可以在编译、类加载、运行时被读取,并执行相应的处理。
Annotation提供了一种为程序元素(包、类、构造器、方法、成员变量、参数、局域变量)设置元数据的方法。
Annotation不能运行,它只有成员变量,没有方法。Annotation跟public、final等修饰符的地位一样,都是程序
元素的一部分,Annotation不能作为一个程序元素使用。
通过使用Annotation,开发人员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充的信息
1、定义Annotation
使用@interface关键字(在原有interface关键字前增加@符号)。定义一个新的Annotation类型与定义一个接口很像。
定义完该Annotation后,就可以在程序中使用该Annotation。
使用Annotation,非常类似于public、final这样的修饰符,通常,会把Annotation另放一行,并且放在所有修饰符之前。
- @Test
- public class MyClass{
- ....
- }
1.1 成员变量
Annotationa只有成员变量!没有方法,Annotation的成员变量在Annotation定义中以“无形参的方法”形式来声明,
成员变量以方法的形式来定义,其返回值定义了该成员变量的类型。
- public @interface MyTag{
-     string name();
-     int age();
- }
在Annotation里定义了成员变量后,使用该Annotation时就应该为该Annotation的成员变量指定值
- public class Test{
-     @MyTag(name="红薯",age=30)
-     public void info(){
-     ......
-     }
- }
也可以在定义Annotation的成员变量时,为其指定默认值,指定成员变量默认值使用default关键字。
- public @interface MyTag{
-     string name() default "我兰";
-     int age() default 18;
- }
Annotation的成员变量已经指定了默认值,使用该Annotation时可以不为这些成员变量指定值,而是直接使用默认值。
- public class Test{
-     @MyTag
-     public void info(){
-     ......
-     }
- }
根据Annotation是否包含成员变量,可以把Annotation分为如下两类:
标记Annotation:没有成员变量的Annotation被称为标记。这种Annotation仅用自身的存在与否来为我们提供信息,例如  
                              @override等。
元数据Annotation:包含成员变量的Annotation。因为它们可以接受更多的元数据,因此被称为元数据Annotation。
1.2 元注解
JDK提供的元注解来修饰Annotation定义
@Retention:用于指定Annotation可以保留多长时间,包含一个名为“value”的成员变量
value:
RetentionPolicy.SOURCE:Annotation只保留在源代码中,编译器编译时,直接丢弃这种Annotation。
RetentionPolicy.CLASS:编译器把Annotation记录在class文件中。当运行Java程序时,JVM中不再保留该Annotation。RetentionPolicy.RUNTIME:编译器把Annotation记录在class文件中。当运行Java程序时,JVM会保留该Annotation,
                                               程序可以通过反射获取该Annotation的信息。
- //直接指定
- @Retention(RetentionPolicy.RUNTIME)
- public @interface MyTag{
-     String name() default "我兰";
- }
如果Annotation里有一个名为“value“的成员变量,使用该Annotation时,可以直接使用XXX(val)形式为value成员变量赋值,无须使用name=val形式。
比如:xUtils里面的
@Target:指定Annotation用于修饰哪些程序元素。
ElementType.TYPE:能修饰类、接口或枚举类型
ElementType.FIELD:能修饰成员变量
ElementType.METHOD:能修饰方法
ElementType.PARAMETER:能修饰参数
ElementType.CONSTRUCTOR:能修饰构造器
ElementType.LOCAL_VARIABLE:能修饰局部变量
ElementType.ANNOTATION_TYPE:能修饰注解
ElementType.PACKAGE:能修饰包
- @Target({ ElementType.FIELD, ElementType.METHOD })
- public @interface AnnTest {
-     String name() default "sunchp";
- }
@Documented:如果定义注解A时,使用了@Documented修饰定义,则在用javadoc命令生成API文档后,
所有使用注解A修饰的程序元素,将会包含注解A的说明。
- @Documented
- public @interface Testable {
- }
- public class Test {
-     @Testable
-     public void info() {
-     }
- }
@Inherited:指定Annotation具有继承性。
1.3 基本Annotation
JDK默认提供了如下几个基本Annotation:
@Override 限定重写父类方法。对于子类中被@Override 修饰的方法,如果存在对应的被重写的父类方法,则正确;如果不存在,则报错。@Override 只能作用于方法,不能作用于其他程序元素。 
@Deprecated 用于表示某个程序元素(类、方法等)已过时。如果使用被@Deprecated修饰的类或方法等,编译器会发出警告
@SuppressWarning 抑制编译器警告。指示被@SuppressWarning修饰的程序元素(以及该程序元素中的所有子元素,例如类以及该类中的方法.....)取消显示指定的编译器警告。例如,常见的@SuppressWarning(value="unchecked") ;
@SafeVarargs @SafeVarargs是JDK 7 专门为抑制“堆污染”警告提供的。
2、提取Annotation信息(反射)
当开发者使用了Annotation修饰了类、方法、Field等成员之后,这些Annotation不会自己生效,
必须由开发者提供相应的代码来提取并处理Annotation信息。
PS:如果想要在运行时提取注解信息,在定义注解时,该注解必须使用@Retention(RetentionPolicy.RUNTIME)修饰。
JDK主要提供了两个类,来完成Annotation的提取:
java.lang.annotation.Annotation接口:这个接口是所有Annotation类型的父接口(后面会分析Annotation的本质,
                                                                Annotation本质是接口,而java.lang.annotation.Annotation接口是这些接
                                                                口的父接口)。
- //java.lang.annotation.Annotation接口源码:
- package java.lang.annotation;
- public interface Annotation {
-     boolean equals(Object obj);
-     int hashCode();
-     String toString();
-     Class<? extends Annotation> annotationType();
- }
annotationType( ),用于返回该注解的java.lang.Class。
java.lang.reflect.AnnotatedElement接口:该接口代表程序中可以被注解的程序元素。
- //java.lang.reflect.AnnotatedElement接口源码:
- package java.lang.reflect;
- import java.lang.annotation.Annotation;
- public interface AnnotatedElement {
-      boolean isAnnotationPresent(Class<? extends Annotation> annotationClass);
-      <T extends Annotation> T getAnnotation(Class<T> annotationClass);
-      Annotation[] getAnnotations();
-      Annotation[] getDeclaredAnnotations();
- }
所以程序通过反射获取了某个类的AnnotatedElement对象(例如,A类method1()方法的java.lang.reflect.Method对象)后,
就可以调用该对象的isAnnotationPresent( )、getAnnotation( )等方法来访问注解信息。
在编译器编译注解定义时,自动在class文件中,添加与成员变量同名的抽象方法,用于反射时获取成员变量的值。通过上面的示例
可以看出,其实Annotation十分简单,它是对源代码增加的一些特殊标记,这些特殊标记可通过反射获取,当程序获取这些特殊标
记后,程序可以做出相应的处理。
Demo:AnnotationTest
注解Annotation
原文:http://www.cnblogs.com/fruitbolgs/p/4515170.html