当前位置: 代码迷 >> Android >> Android Annotation诠注的剖析和使用
  详细解决方案

Android Annotation诠注的剖析和使用

热度:108   发布时间:2016-04-28 02:20:32.0
Android Annotation注解的剖析和使用

都说Annotation的运用非常简单,但真正我们需要下手实现的的时候,有的时候就不知道从哪里下手,为什么我们觉得很简单的东西,但却无法下手呢?
原因只有一个,我们对它的使用非常少,但对于写框架的人来说Annotation却使用的频率非常高。那既然我们平时用的非常少,我写这篇blog就没什么意义了,的确,那我也只当是给大家做个查阅的文档。不过我还是希望大家能通过这篇blog,加强对Annotation的理解,这篇blog省去了Annotation不必要的知识点,就像慕课网所说的只学有用的。
进入主题:
一、先分析源码:
只需要知道一下四个类就行了
1、

  @Documented  @Retention(RetentionPolicy.RUNTIME)  @Target(ElementType.ANNOTATION_TYPE)  public @interface Retention {      RetentionPolicy value();  }

这个注解的作用是当我们需要声明自定义的Annotation是,需要用到此注解,还需要设置value的值;value的值的作用,就需要讲第二个类的时候说明,使用方法,可以参考此类本身,[email protected](RetentionPolicy.RUNTIME),[email protected](value = RetentionPolicy.RUNTIME),效果是一样的,这里需要注意一点的是,Annotation可以用自己来对自己进行注解说明。
2、

  public enum RetentionPolicy {      /**       * Annotation is only available in the source code.       */      SOURCE,      /**       * Annotation is available in the source code and in the class file, but not       * at runtime. This is the default policy.       */      CLASS,      /**       * Annotation is available in the source code, the class file and is       * available at runtime.       */      RUNTIME  }

这个是一个枚举类型,功能是控制Annotation的级别,值越大,权限越高,Annotation的作用范围越大,下面分别解释三个级别的作用范围:
SOURCE:只在源文件此注解中有效,也就是,只要代码已经编译过了,权限被声明为SOURCE的Annotation就无效;
CLASS: 文件或者代码已经编译了,这个时候还有效,当代码跑起来了的时候,就没有效果了;
RUNTIME:这个相当于最大权限,记住可用于任何时候,而我们在写代码的时候,都是希望在运行时候用,所以,一般情况下我们都是声明为RUNTIME权限。

3、

  @Documented  @Retention(RetentionPolicy.RUNTIME)  @Target(ElementType.ANNOTATION_TYPE)  public @interface Target {      ElementType[] value();  }

这又是一个注解类,这个类的作用也是在我们自定义Annotation的时候声明,然后确定自定义Annotation的作用类型是那个地方,它的取值就是下一个类所要讲的,用法与Retention注解一样,确切的说所有的Annotation都是这样使用
4、

  public enum ElementType {      /**       * Class, interface or enum declaration.       */      TYPE,      /**       * Field declaration.       */      FIELD,      /**       * Method declaration.       */      METHOD,      /**       * Parameter declaration.       */      PARAMETER,      /**       * Constructor declaration.       */      CONSTRUCTOR,      /**       * Local variable declaration.       */      LOCAL_VARIABLE,      /**       * Annotation type declaration.       */      ANNOTATION_TYPE,      /**       * Package declaration.       */      PACKAGE  }

这个类就是确定Annotation的作用位置,每个不同的值,对应的位置不相同
/**
* 作用于类,接口或枚举
*/
TYPE,
/**
* 作用于字段,也就是成员变量.
*/
FIELD,
/**
* 作用于方法.
*/
METHOD,
/**
* 参数.
*/
PARAMETER,
/**
* 构造方法.
*/
CONSTRUCTOR,
/**
* 本地变量.
*/
LOCAL_VARIABLE,
/**
* 注解.
*/
ANNOTATION_TYPE,
/**
* 包名.
*/
PACKAGE
我只是把英文翻译了一遍,如果有错请指正。
基本用法介绍完了,接下来开始自定义Annotation
二、自定义Annotation
通过Android studio创建Annotation类,创建类的时候可以直接指定Annotation类型,这样创建出来的文件如下:

  /**   * Created by moon.zhong on 2015/2/14.   */  public @interface TestAnnotation {  }

和接口非常像,只不过多了一个@,根据刚刚所讲,[email protected](RetentionPolicy.RUNTIME)来确定权限的大小,这里直接采用最大权限,[email protected](ElementType.METHOD),这里指定作用于方法上面
自定义Annotation就完成了。

三、使用Annotation
写任何代码都不是用来看的,所以我们一定得知道如何使用它。
Annotation往往是跟反射结合起来使用的,我们在学习反思的时候,知道反射里面很多方法获取Annotation的值,也可以得出这样一个结论,用到了Annotation的情况下,基本上就用到了反射,我们常说的一句话,无反射,不框架,这也是为什么但大部分框架都大量使用Annotation的原因
这里也是用反射的列子来说明Annotation的使用
编写好自定义的Annotation,让其作用范围在类上面,

  /**   * Created by moon.zhong on 2015/2/14.   */  @Retention(value = RetentionPolicy.RUNTIME)  @Target(value = ElementType.TYPE)  public @interface ClassAnnotation {  }

定义好一个Bean的类,加上注解

  /**   * Created by moon.zhong on 2015/2/14.   */  @ClassAnnotation  public class Bean {  }

通过反射来查看注解是否已经能正常使用

  public class MainActivity extends ActionBarActivity {      @Override      protected void onCreate(Bundle savedInstanceState) {          super.onCreate(savedInstanceState);          setContentView(R.layout.activity_main);          Class<?> mClass = Bean.class ;          Annotation annotation[] = mClass.getAnnotations() ;          for (Annotation a : annotation){              Log.v("zgy","====getAnnotations===="+a.annotationType()) ;          }      }  }

最后打印的log信息:zgy﹕ ====getAnnotations====interface moon.annotationdemo.ClassAnnotation

再来看看怎么给自定义的Annotation设置值,[email protected](RetentionPolicy.RUNTIME)一样后面可以跟上一个值。在上面看log信息的时候,你是否发现了多打印了一个interface,而后面紧跟着的才是Annotation的全名,其实Annotation本省就是接口的一种,所以在声明变量的时候,只需定义一个抽象方法即可,不需要实现,完全可以参照 public @interface Retention

  /**   * Created by moon.zhong on 2015/2/14.   */  @Retention(value = RetentionPolicy.RUNTIME)  @Target(value = ElementType.TYPE)  public @interface ClassAnnotation {      String print() ;  }  /**   * Created by moon.zhong on 2015/2/14.   */  @ClassAnnotation(print = "annotation")  public class Bean {  }

使用也是一样的同 @interface Retention ,[email protected](print = “annotation”),这里有一点需要注意,[email protected](“annotation”),因为这里定义的方法是print(),如果换成value() 就可以省略。

    /**     * Created by moon.zhong on 2015/2/14.     */    @Retention(value = RetentionPolicy.RUNTIME)    @Target(value = ElementType.TYPE)    public @interface ClassAnnotation {        String value() ;    }    /**     * Created by moon.zhong on 2015/2/14.     */    @ClassAnnotation("annotation")    public class Bean {    }
来测试下:      for (Annotation a : annotation){          Log.v("zgy","====print===="+((ClassAnnotation)a).print()) ;      }打印log的信息 zgy﹕ ====print====annotation说明我们已经拿到了所设置的值,那么接下来要实现什么要的功能就看大家的智慧了。

四、总结:
老规矩,就像烧菜最后都要浇汁,这里来做个总结,在定义Annotation的时候,需要注意两点,[email protected](RetentionPolicy.RUNTIME)注解来确定声明的Annotation的作用权限,这里一般设为最大就可以了;[email protected](ElementType.ANNOTATION_TYPE)注解来确定此注解的作用对象是谁。还有一点需要注意,自定义的Annotation如果定义了抽象方法,如果抽象方法名为value的时候,使用的时候可以省略,其他时候不能省略,个人建议,都加上。

1楼hm15026小时前
大牛!
  相关解决方案