Android知识程序员Android开发

Java注解(Annotation)详解

2018-05-23  本文已影响74人  幻海流心

Java注解(Annotation)详解

1.Annotation的概念

An annotation is a form of metadata, that can be added to Java source code. Classes, methods, variables, parameters and packages may be annotated. Annotations have no direct effect on the operation of the code they annotate.

2.Annotation分类

3.元Annotation

4.自定义Annotation

  1. 创建自定义Annotation流程

    • public @interface 自定义注解名称
      public @interface CustomAnnotation{***}
          
      
    • 设置自定义Annotation的保留范围和目标,Retention和Target是最重要的两个元Anitation.
      @Retention( RetentionPolicy.RUNTIME )
      @Target( ElementType.TYPE )
      public @interface CustomAnnotation{***}
      
    • 设置自定义Annotation的注解参数(注解成员)
      • 注解参数支持的数据类型
        • 所有基本数据类型(int,float,boolean,byte,double,char,long,short)
        • String类型
        • Class类型
        • enum类型
        • Annotation类型
        • 以上所有类型的一维数组
      • 注解参数声明方式
        @Retention( RetentionPolicy.RUNTIME )
        @Target( ElementType.TYPE )
        public @interface CustomAnnotation{
            //注解参数类型可以是1-6中任一种,包括枚举
            public enum Skill{JAVA,ANDROID,IOS}
            Skill mySkill() default Skill.ANDROID;
            String attr1();
            //可以使用default设置默认值
            int attr2() default 100;
            //修饰符只能用public
            public boolean attr3() default false;
        }
        @Retention( RetentionPolicy.RUNTIME )
        @Target( ElementType.TYPE )
        public @interface CustomAnnotation{
            //只有一个注解参数,使用value()
            String value();
        }
        
        • 自定义Annotation的参数类型必须满足上一条1到6中的范围.
        • 自定义Annotation的参数访问方法只能是public,或不写.
        • 自定义Annotation的参数可以加 default 设置默认值.
        • 自定义Annotation若只有1个参数,使用value().
  2. 自定义Annotation的注解参数的默认值

    注解元素必须有确定的值,要么在定义注解的默认值中指定,要么在使用注解时指定,非基本类型的注解元素的值不可为null。因此, 使用空字符串或0作为默认值是一种常用的做法。这个约束使得处理器很难表现一个元素的存在或缺失的状态,因为每个注解的声明中,所有元素都存在,并且都具有相应的值,为了绕开这个约束,我们只能定义一些特殊的值,例如空字符串或者负数,一次表示某个元素不存在,在定义注解时,这已经成为一个习惯用法。

    示例:
    @Target(ElementType.FIELD)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface AnotherAnnotation{
        String author() default "";
        int age() default -1;
    }
    
  3. 使用刚刚创建的自定义注解

    @CustomAnnotation(attr1 = "属性1", attr2 = 90, attr3 = true)
    public class AnnotationTestClass{
        ***
    }
    

5.Annotation解析


6.编译时Annotation解析

编译时Annotation解析 相对复杂,下面单独进行分析

首先申明:下面内容仅仅讨论 编译时Annotation的解析

  1. 编译时Annotation的解析,是由Annotation Processor完成
  2. Annotation Processor(注解处理器)
    • 注解处理器是一个在javac中的,用来在编译时扫描和处理注解的工具
    • 我们可以为特定的注解,注册自定义的注解处理器
    • 在编译期间,JVM会自动运行注册过的注解处理器
    • 一个注解的Annotation Processor,以Java代码(或者编译过的class)为输入,生成.java文件作为输出.这意味着我们可以生成新的Java代码!这些生成的Java代码是在生成的.java文件中,新生成的.java文件会和普通的手动编写的Java源代码一样被javac编译
  3. 每一个注解处理器都是继承于AbstractProcessor,需要关注的有以下4个方法
public abstract class AbstractProcessor implements Processor {

    //对一些工具进行初始化
    public synchronized void init(ProcessingEnvironment processingEnv)
    
    //你在这里定义你的注解处理器注册到哪些注解上,必须指定;
    //它的返回值是一个字符串的集合,包含本处理器想要处理的注解类型的合法全称
    public Set<String> getSupportedAnnotationTypes()
    
    //指定该注解处理器使用的JAVA版本,通常返回SourceVersion.latestSupported()
    public SourceVersion getSupportedSourceVersion()
    
    //真正生成java代码的地方
    //annotations:请求处理的注解类型集合
    //roundEnv:可以让你查询出包含特定注解的被注解元素,相当于“有关全局源码的上下文环境”
    //如果返回 true,则这些注解已声明并且不要求后续 Processor 处理它们;
    //如果返回 false,则这些注解未声明并且可能要求后续 Processor 处理它们
    public abstract boolean process(Set<? extends TypeElement> annotations,RoundEnvironment roundEnv)
    
}
  1. 自定义注解处理器,就是继承AbstractProcessor并重写上述4个方法

关于编译时Annotation解析,这里推荐一篇文章【Android】注解框架(三)-- 编译时注解,手写ButterKnife,按照文章上面流程敲一遍代码,相信可以对自定义注解的创建及解析有一个深入的了解!

上一篇 下一篇

猜你喜欢

热点阅读