注解的使用

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);

你可能感兴趣的:(注解的使用)