java API提供四个元注解分别是:@Target,@Retention,@Documented,@Inherited。是专门用来定义注解的注解。其作用分别是:
@Target 表示该注解用于什么地方,可能的值在枚举类 ElemenetType 中,包括:
ElemenetType.CONSTRUCTOR----------------------------构造器声明
ElemenetType.FIELD --------------------------------------域声明(包括 enum 实例)
ElemenetType.LOCAL_VARIABLE------------------------- 局部变量声明
ElemenetType.METHOD ----------------------------------方法声明
ElemenetType.PACKAGE --------------------------------- 包声明
ElemenetType.PARAMETER ------------------------------参数声明
ElemenetType.TYPE--------------------------------------- 类,接口(包括注解类型)或enum声明
@Retention 表示在什么级别保存该注解信息。可选的参数值在枚举类型 RetentionPolicy 中,包括:
RetentionPolicy.SOURCE ---------------------------------注解将被编译器丢弃
RetentionPolicy.CLASS -----------------------------------注解在class文件中可用,但会被VM丢弃
RetentionPolicy.RUNTIME VM-------将在运行期也保留注释,因此可以通过反射机制读取注解的信息。
@Documented 将此注解包含在 javadoc 中 ,它代表着此注解会被javadoc工具提取成文档。在doc文档中的内容会因为此注解的信息内容不同而不同。相当与@see,@param 等。
@Inherited 允许子类继承父类中的注解。
1.首先来看RUNTIME级别的注解的例子。
定义一个注解:
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD,ElementType.METHOD})
@Documented
public @interface AddData {
String EventType() default "";
}
定义了一个运行期的注解,它的作用范围是 变量(FIELD) 和 方法(METHOD)
写一个方法,在运行时解析注解
public static void searchAllData(Object o){
if(o == null){
return;
}
final Class<?> clazz = o.getClass(); //类
if(clazz.isAnnotationPresent(AddData.class)){
AddData testAnno = clazz.getAnnotation(AddData.class);
Logger.doEvent("TEST_ANNO_C",testAnno.EventType());
}
Field[] fields = clazz.getDeclaredFields();//成员变量类
for (Field field : fields) {
if (field.isAnnotationPresent(AddData.class)) {
AddData testAnno = field.getAnnotation(AddData.class);
Logger.doEvent("TEST_ANNO_F",testAnno.EventType());
}
}
Method[] methods = clazz.getDeclaredMethods();//方法
for(Method method:methods){
if(method.isAnnotationPresent(AddData.class)){
AddData testAnno = method.getAnnotation(AddData.class);
Logger.doEvent("TEST_ANNO_M",testAnno.EventType());
}
}
}
使用:
注解成员变量:
@AddData(EventType = "3232")
private boolean isGood;
注解方法:
@AddData(EventType = "1213")
public void checkUpdate(){
}
解析:
Engine.searchAllData(this);
网友评论