注解的使用

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

推荐阅读更多精彩内容

  • 注解支持的版本 Android support library从19.1版本开始就引入了一个新的注解库。 添加支持...
    街头客阅读 5,805评论 4 16
  • 前言 对注解,一开始是在学习java的时候接触到的,就是在《Thinking in Java》里草草看过。后来开发...
    许方镇阅读 3,687评论 0 6
  • 四大基本注解类型 @Documented是否使用文档注释,使用则会保留class文件的注释@Target({Ele...
    RoboyCore阅读 67评论 0 0
  • 整体Retrofit内容如下: 1、Retrofit解析1之前哨站——理解RESTful 2、Retrofit解析...
    隔壁老李头阅读 4,530评论 4 29
  • 我一直坚信:“人生因选择而不同,因坚持而精彩”,但真正去做好却不是一件容易的事。人的一生会面临太多的诱惑和比较,很...
    little_niu阅读 616评论 0 2