频道栏目
IT货架 > > 正文
JavaAnnotation机制源码分析与使用 1 Annotation
网友分享于:Jun 12, 2018 11:47:55 PM    来源: IT货架   

1 Annotation

1.1 Annotation 概念及作用

    1.  概念

  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.[3]

  能够添加到 Java 源代码的语法元数据。类、方法、变量、参数、包都可以被注解,可用来将信息元数据与程序元素进行关联。

  更直观的理解,它提供了一种安全的类似注释的机制,用来将任何的信息或元数据(metadata)与程序元素(类、方法、成员变量等)进行关联。

    2.  定义

  Annotation通过如下的方式进行定义

  其中的@interface是一个关键字,这个关键字声明隐含了一个信息:它是继承了java.lang.annotation.Annotation接口,并非声明了一个interface。在设计annotations的时候必须把一个类型定义为@interface,而不能用class或interface关键字。定义的详细内容参考[1.2.3]自定义Annotation一节。

  3.  作用

  Annotation的引入是为了从Java语言层面上,为Java源代码提供元数据的支持

  (1).   标记,用于告诉编译器一些信息

    Marker Annotation:该Annotation没有参数输入,更多类似于标识一个东西,类似于Java语言中的java.io.Serialable之类的接口,并无需要实现的方法。

  (2).   编译时动态处理,如动态生成代码

  (3).   运行时动态处理,如得到注解信息

1.2  Annotation 分类

1.2.1    标准 Annotation

    1.     @Override

 2.     @Deprecated

 3.    @SuppressWarnings

  标准Annotation是指Java自带的几个Annotation,上面三个分别表示重写函数,函数已经被禁止使用,忽略某项Warning

1.2.2    元 Annotation

 元Annotation是指用来定义Annotation的Annotation

   1.   @Retention

 @Retention表示Annotation作用范围和保留时间,可选值SOURCE(源码时),CLASS(编译时),RUNTIME(运行时),默认为 CLASS,值为 SOURCE 大都为Mark   Annotation,这类Annotation 大都用来校验,比如Override, SuppressWarnings

 2.     @Target

  @Target 表示Annotation可以用来修饰哪些程序元素,如 TYPE, METHOD, CONSTRUCTOR, FIELD, PARAMETER 等,未标注则表示可修饰所有

 3.     @Inherited[4][5]

  @Inherited 表示父类Annotation可以被子类继承

  @Inherited标识某个被标注的类型是被继承的。使用了@Inherited修饰的annotation类型被用于一个class之时,则这个annotation将被用于该class的相应子类。

  注意:@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation,方法并不从它所重载的方法继承annotation。

   当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME,则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个  @Inherited annotation类型的annotation时,反射代码检查将展开工作:检查class和其父类,直到发现指定的annotation类型被发现,或者到达类继承结构的顶层。

  就是说, 查看查找@Inherited过的Annotation之时,需要反复的向上查找,方才可以。

   4.     @Documented

  @Documented所修饰的Annotation连同自定义Annotation所修饰的元素一同保存到Javadoc文档中

1.2.3    自定义Annotation

  自定义Annotation表示自己根据需要定义的Annotation,定义时需要用到上面的元Annotation。这里只是一种分类而已,也可以根据作用域分为源码时、编译时、运行时 Annotation。

  下面通过自定义Annotation MethodInfo,以实例来具体介绍自定义Annotation的使用。

 1.   自定义Annotation定义

  MethodInfo Annotation定义部分:

  (1)   通过@interface 定义,注解名即为自定义注解名

  (2)   注解配置参数名为注解类的方法名,且:

    a)   所有方法没有方法体,方法名即为属性名,没有参数没有修饰符,实际只允许 public & abstract 修饰符,默认为 public ,不允许抛异常

    b)  方法返回值只能是基本类型,String, Class, annotation, enumeration 或者是他们的一维数组,返回类型即为属性类型

    c)  若只有一个默认属性,可直接用 value() 函数。一个属性都没有表示该 Annotation 为 Mark Annotation

    d)  可以加 default 表示默认值,null不能作为成员默认值

   2.      自定义Annotation调用

  •  

这里是调用自定义Annotation--MethodInfo的示例,MethodInfo Annotation 作用为给方法添加相关信息,包括 author、date、version

   3.      运行时Annotation解析

  (1).   Annotation解析API

  运行时Annotation指@Retention为RUNTIME的Annotation,可手动调用下面常用 API 解析。

  其中Constructor,Field,Method都继承类class AccessibleObject implements AnnotatedElement;可通过如下接口来解析annotation:

  • element.getAnnotation(AnnotationName.class):

  表示得到element某个 AnnotationName的信息,因为一个 Target 可以被多个 Annotation 修饰

  •  element.getAnnotations( ) :

  则表示得到element所有Annotations

  • element.isAnnotationPresent(AnnotationName.class):

  表示该元素是否被某个 AnnotationNam修饰

  (2).    App解析实例分析

  以上解析代码以MethodInfo Annotation为例,利用 Target(这里是 Method)getAnnotation函数得到Annotation信息,然后就可以调用Annotation的方法得到响应属性值

  4.      编译时Annotation解析

  (1).     编译时Annotation解析过程

  编译时Annotation指@Retention为CLASS 的Annotation,由apt(Annotation Processing Tool) 解析自动解析。

  需要做的

    a)   自定义类集成自AbstractProcessor

    b)   重写其中的 process 函数

      实际是 apt(Annotation Processing Tool) 在编译时自动查找所有继承自 AbstractProcessor 的类,然后调用他们的 process 方法去处理

  (2).     解析示例

  假设之前自定义的MethodInfo的@Retention为CLASS,

  SupportedAnnotationTypes表示这个Processor要处理的Annotation 名字。process函数中参数annotations表示待处理的 Annotations,参数 env 表示当前或是之前的运行环境, process函数返回值表示这组annotations是否被这个 Processor 接受,如果接受后续子的 rocessor不会再对这个Annotations 进行处理。

  

参考

[1].    The Java™ Tutorials : http://docs.oracle.com/javase/tutorial/java/annotations/

[2].   APT: Compile-Time Annotation Processing with Java

http://www.javalobby.org/java/forums/t17876.html

[3].   Java annotation : http://en.wikipedia.org/wiki/Java_annotation

[4].     Java中@Inherited注解的运用: http://xiangdefei.iteye.com/blog/1044199

[5].   Annotation Inheritance Examples: http://www.jroller.com/alessiopace/entry/annotation_inheritance_examples

 


广告服务联系QQ:1134687142 | 网站地图

版权所有: IT货架- 内容来自互联网,仅供用于技术学习,请遵循相关法律法规. 京ICP备11030978号-1