Annotation简介:
          Annotation提供一种机制,将程序中元素(如类、方法、属性等)和元数据联系起来。这样编译器可以将元数据保存的class文件中。代码分析工具就可以使用这些元数据执行的额外任务。注释采用“at”标记形式 ( @ ),后面是注释名称。

自定义 annotationDebug.java
package annotation.test;

import java.lang.annotation.Documented;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.ElementType;
import java.lang.annotation.Target;

    
/*
     * annotation类型是一种接口,能够通过java反射API的方式提供对其信息的访问
     
*/


    
/*
     * Documented 产生Java Doc文件,这次可以看到文件中包括了@Debug的信息
     
*/

@Documented
    
/*
     * 限定 annotation 使用对象 - Target 
     * 在定义annotation时,使用java.lang.annotation.Target可以定义annotation使用的时机。
     * public enum ElementType {
     *   TYPE, // 适用 class, interface, enum
     *   FIELD, // 适用 field
     *   METHOD, // 适用 method
     *   PARAMETER, // 适用 method 上之 parameter
     *   CONSTRUCTOR, // 适用 constructor
     *   LOCAL_VARIABLE, // 适用区域变量
     *   ANNOTATION_TYPE, // 适用 annotation 型态
     *   PACKAGE // 适用 package
     *   } 
     
*/

@Target(
{ElementType.CONSTRUCTOR, ElementType.METHOD})//指定目标
    /*
     * Retention 在你自定义的形态中,指定编译器如何处理自定义的annotation
     * 告知编译器如何处理 annotaion - Retention 
     * RetentionPolicy
     *         SOURCE        编译器处理完Annotation信息后就没事了
     *         CLASS        编译器将Annotation储存于class档中,预设
     *         RUNTIME        编译器将Annotation储存于class檔中,可由VM读入
     *                     使用java设计的一个程序代码工具,从VM中读出Annotation信息,已在分析程序中使用。
     *                     搭配Reflection机制,就可以实现。
     *         
     *         J2SE 5.0中新增了java.lang.reflect.AnnotatedElement这个接口,当中定义有四个方法:
     *                 public Annotation getAnnotation(Class annotationType);
     *                 public Annotation[] getAnnotations();
     *                 public Annotation[] getDeclaredAnnotations();
     *                 public boolean isAnnotationPresent(Class annotationType);
     *         Class、Constructor、Field、Method、Package等类别,都实作了 AnnotatedElement这个接口,
     *         所以您可以从这些类别的实例上,分别取得标示于其上的Annotation与其信息,
     *         如果 RetentionPolicy为RUNTIME的话。

     
*/

     
@Retention(RetentionPolicy.RUNTIME)
//设置保持性
    /*
     * @Inherited 子类是否继承父类的 annotation 
     
*/

@Inherited
public @interface Debug {
    
//定义了value()方法,编译器在编译时会自动帮您产生一个value的变量成员,接着在使用Debug Annotation时要指定值
    
//注释类型的数据成员被设置成使用有限信息进行工作
    
//定义数据成员不需要分别定义访问和修改的方法,只需定义一个方法,以数据成员的名称命名它,数据类型应该是该方法返回值的类型.
    String value()default "windfree";//默认值的类型必需与成员变量的申明类型一置
    String name();
}



在程序中使用自定义的annotation
   TestDebug.java
package annotation.test;

public class TestDebug {
    @Debug(
               name 
= "zgliu"
            )
     
public void doSomething() {        
        }

}


使用java中反射API读取class中的元数据的信息
      DebugTool.java:
package annotation.test;

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

public class DebugTool {
    
public static void main(String []args)throws NoSuchMethodException {
        Class
<TestDebug> c=TestDebug.class;
        Method method 
= c.getMethod("doSomething");
        
if(method.isAnnotationPresent(Debug.class)) {
            System.out.println(
"@Debug is found.");
            Debug debug 
= method.getAnnotation(Debug.class);
            System.out.println(
"\tvalue = " + debug.value());
            System.out.println(
"\tname = " + debug.name());
        }

        
else {
            System.out.println(
"@Debug is not found.");
        }


        Annotation[] annotations 
= method.getAnnotations();
        
for(Annotation annotation : annotations) {
            System.out.println(
                    annotation.annotationType().getName());
        }

    }

}

Java标准Annotation
@Deprecated 相当于Javadoc的@deprecated,被@Deprecated标注的对象class, method等被注明为不推荐使用。主要用于javac等编译工具。
@Override 注明对象method重载了父类的方法。javac等编译工具编译时会根据此Annotation判断重载方法是否正确。
@SuppressWarnings 告诉javac等编译器忽略所指定的特定的警告信息。
@Target 被定义的annotation可以附加在那些对象上。
@Retention annotation的作用期间。

定义一个annotation
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
 
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {①定义一个注释
int init();
}


import java.lang.annotation.Annotation;
public class TestAnnotation {
  @MyAnnotation(init 
= 2)②使用注释
  
public void print(){
     System.out.println(TestAnnotation.
class.getName());
  }

  
public static void main(String[] args) throws Exception{
     TestAnnotation ta 
= new TestAnnotation();
     Annotation[] annotations 
= ta.getClass().getMethod("print").getAnnotations();③
     
for (Annotation annotation : annotations)  {              
         System.out.println(
"MyAnnotation.init : " + 
       ((MyAnnotation)annotation).init());④打印出init的值
        }
 
  }

}



我们定义了一个名为MyAnnotation的注释而这个注释中只有一个类型为int名为init的属性,我们在②处使用了我们刚刚定义的注释并且为init赋值为2,在③处我们通过反射机制获得print方法上定义的所有注释然后通过迭代将其值init打印至控制台。

最终在控制台输出以下信息:
MyAnnotation.init : 2