JDK5.0新特性Annotation之@Retention注解

直接代码说话，说明信息详见注释。。

首先是自定义的使用@Retention标注的注解----MyAnnotation.java

package com.jadyer.annotation.retention;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String hello() default "haerbin";
    String world();
}
/*********************【@Retention用来告知编译程序如何处理注解】********************************************************/
//java.lang.annotation.Retention型态可以在定义Annotation型态时，指示编译程序如何对待自定义的Annotation型态
//预设上编译程序会将Annotation信息留在.class档案中，但不被虚拟机读取，仅用于编译程序或工具程序运行时提供信息
//在使用Retention型态时，需要提供java.lang.annotation.RetentionPolicy的枚举型态
//java.lang.annotation.RetentionPolicy.CLASS----默认值。编译程序将Annotation储存于class档中
//java.lang.annotation.RetentionPolicy.SOURCE---编译程序处理完Annotation信息后就完成任务
//                                              该注释将不被记录在类文件中，而只是存在于.java文件中
//java.lang.annotation.RetentionPolicy.RUNTIME--编译程序将Annotation储存于class档中，可由JVM读入
//                                              即编译器将把注释记录在类文件中，在运行时JVM将保留注释
//                                              故可搭配反射(Reflection)机制让JVM读取Annotation信息
/*********************【@SuppressWarnings用来告知编译程序来抑制警告】***************************************************/
//其中@SuppressWarnings注解的RetentionPolicy就是SOURCE，即仅在编译时告知编译程序来抑制警告
//如果@SuppressWarnings中定义不存在的警告类型，那么程序也不会报错
//如果@SuppressWarnings中定义了重名的警告类型，那么后面的将全部被忽略掉
/*****************************************************************************************************************/

 

然后是自定义的@MyAnnotation注解的测试类----MyTest.java

package com.jadyer.annotation.retention;

public class MyTest {
    @Deprecated
    @SuppressWarnings("unchecked")
    @MyAnnotation(hello = "beijing", world = "chongqing")
    public void output() {
        System.out.println("output something");
    }
}

 

最后利用反射机制读取MyTest.java中的Annotation信息的类----MyReflection.java

package com.jadyer.annotation.retention;

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

/**
 * 利用反射机制，读取MyTest.java中的Annotation信息
 * @see 控制台打印结果，如下
 * @see output something
 * @see beijing
 * @see chongqing
 * @see java.lang.Deprecated
 * @see com.jadyer.annotation.retention.MyAnnotation
 */
public class MyReflection {
    public static void main(String[] args) throws Exception {
        MyTest myTest = new MyTest();
        Class<MyTest> c = MyTest.class;
        Method method = c.getMethod("output", new Class[]{});

        //判断方法前面是否存在特定的Annotation
        if (method.isAnnotationPresent(MyAnnotation.class)) {
            //调用MyTest中的output()方法
            method.invoke(myTest, new Object[]{});

            //获得某一具体的Annotation
            MyAnnotation myAnnotation = method.getAnnotation(MyAnnotation.class);

            //对于Annotation中的元素，赋值时可以把它当作属性，取出时可以把它当作方法
            String hello = myAnnotation.hello();
            String world = myAnnotation.world();

            System.out.println(hello);
            System.out.println(world);
        }

        Annotation[] annotations = method.getAnnotations();
        for (Annotation annotation : annotations) {
            //不会打印出@SuppressWarnings注解，因为它的RetentionPolicy是SOURCE
            System.out.println(annotation.annotationType().getName());
        }
    }
}