java元数据

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;
/**
* @author windfree
*
*/
    /*
     * annotation类型是一种接口，能够通过java反射API的方式提供对其信息的访问
     */
    /*
     * Documented 产生Java Doc文件，这次可以看到文件中包括了@Debug的信息
     */

    /*
     * 限定 annotation 使用对象 - Target
     * 在定义annotation时，使用java.lang.annotation.Target可以定义annotation使用的时机。
     */
    /*
     * @Documented Java Doc文件
     */

    /*
     *
     * public enum ElementType {
     *   TYPE, // 适用 class, interface, enum
     *   FIELD, // 适用 field
     *   METHOD, // 适用 method
     *   PARAMETER, // 适用 method 上之 parameter
     *   CONSTRUCTOR, // 适用 constructor
     *   LOCAL_VARIABLE, // 适用区域变量
     *   ANNOTATION_TYPE, // 适用 annotation 型态
     *   PACKAGE // 适用 package
     *   }
     */

    /*
     * 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的话。

     */

    /*
     * @Inherited 子类是否继承父类的 annotation
     */
@Documented
@Target({ElementType.CONSTRUCTOR, ElementType.METHOD}) // 指定目标
@Retention(RetentionPolicy.RUNTIME) // 设置保持性
@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());
        }
    }
}

   学习中的一个完整的例子。