文档章节

Java Annotation 及几个常用开源项目注解原理简析

马孔多
 马孔多
发布于 2016/03/21 14:43
字数 2261
阅读 82
收藏 0

精选30+云产品,助力企业轻松上云!>>>

一、Annotation 示例

Override Annotation

Java
1
2
@Override
public void onCreate ( Bundle savedInstanceState ) ;

Retrofit Annotation

Java
1
2
@GET ( "/users/{username}" )
User getUser ( @Path ( "username" ) String username ) ;

Butter Knife Annotation

Java
1
@InjectView ( R . id . user ) EditText username ;

ActiveAndroid Annotation

Java
1
@Column ( name = Name" ) public String name ;

Retrofit 为符合 RESTful 规范的网络请求框架
Butter Knife 为 View 及事件等依赖注入框架
Active Android 为 ORM 框架
更多见:Android 开源项目汇总

 

二、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.

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

 

2 作用

a. 标记,用于告诉编译器一些信息
b. 编译时动态处理,如动态生成代码
c. 运行时动态处理,如得到注解信息
这里的三个作用实际对应着后面自定义 Annotation 时说的 @Retention 三种值分别表示的 Annotation
看看下面一段代码的运行结果是多少?

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
public class Person {
 
     private int      id ;
     private String name ;
 
     public Person ( int id , String name ) {
         this . id = id ;
         this . name = name ;
     }
 
     public boolean equals ( Person person ) {
         return person . id == id ;
     }
 
     public int hashCode ( ) {
         return id ;
     }
 
     public static void main ( String [ ] args ) {
 
         Set <Person> set = new HashSet <Person> ( ) ;
         for ( int i = 0 ; i < 10 ; i ++ ) {
             set . add ( new Person ( i , "Jim" ) ) ;
         }
         System . out . println ( set . size ( ) ) ;
     }
}

答案见本文最后
 

三、Annotation 分类

1 标准 Annotation

包括 Override, Deprecated, SuppressWarnings,标准 Annotation 是指 Java 自带的几个 Annotation,上面三个分别表示重写函数,不鼓励使用(有更好方式、使用有风险或已不在维护),忽略某项 Warning

2 元 Annotation

@Retention, @Target, @Inherited, @Documented,元 Annotation 是指用来定义 Annotation 的 Annotation,在后面 Annotation 自定义部分会详细介绍含义

3 自定义 Annotation

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

 

四、Annotation 自定义

1 调用

Java
1
2
3
4
5
6
7
8
9
10
public class App {
 
     @MethodInfo (
         author = trinea . cn + android @gmail . com,
         date = "2014/02/14" ,
         version = 2 )
     public String getAppName ( ) {
         return "trinea" ;
     }
}

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

 

2 定义

Java
1
2
3
4
5
6
7
8
9
10
11
12
@Documented
@Retention ( RetentionPolicy . RUNTIME )
@Target ( ElementType . METHOD )
@Inherited
public @interface MethodInfo {
 
     String author ( ) default "trinea@gmail.com" ;
 
     String date ( ) ;
 
     int version ( ) default 1 ;
}

这里是 MethodInfo 的实现部分
(1). 通过 @interface 定义,注解名即为自定义注解名
(2). 注解配置参数名为注解类的方法名,且:
a. 所有方法没有方法体,没有参数没有修饰符,实际只允许 public & abstract 修饰符,默认为 public ,不允许抛异常
b. 方法返回值只能是基本类型,String, Class, annotation, enumeration 或者是他们的一维数组
c. 若只有一个默认属性,可直接用 value() 函数。一个属性都没有表示该 Annotation 为 Mark Annotation
(3). 可以加 default 表示默认值

 

3 元 Annotation

@Documented 是否会保存到 Javadoc 文档中
@Retention 保留时间,可选值 SOURCE(源码时),CLASS(编译时),RUNTIME(运行时),默认为 CLASS,值为 SOURCE 大都为 Mark Annotation,这类 Annotation 大都用来校验,比如 Override, Deprecated, SuppressWarnings
@Target 可以用来修饰哪些程序元素,如 TYPE, METHOD, CONSTRUCTOR, FIELD, PARAMETER 等,未标注则表示可修饰所有
@Inherited 是否可以被继承,默认为 false

 

五、Annotation 解析

1 运行时 Annotation 解析

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

Java
1
2
3
method . getAnnotation ( AnnotationName . class ) ;
method . getAnnotations ( ) ;
method . isAnnotationPresent ( AnnotationName . class ) ;

其他 @Target 如 Field,Class 方法类似
getAnnotation(AnnotationName.class) 表示得到该 Target 某个 Annotation 的信息,因为一个 Target 可以被多个 Annotation 修饰
getAnnotations() 则表示得到该 Target 所有 Annotation
isAnnotationPresent(AnnotationName.class) 表示该 Target 是否被某个 Annotation 修饰
(2) 解析示例如下:

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public static void main ( String [ ] args ) {
     try {
         Class cls = Class . forName ( "cn.trinea.java.test.annotation.App" ) ;
         for ( Method method : cls . getMethods ( ) ) {
             MethodInfo methodInfo = method . getAnnotation (
MethodInfo . class ) ;
             if ( methodInfo != null ) {
                 System . out . println ( "method name:" + method . getName ( ) ) ;
                 System . out . println ( "method author:" + methodInfo . author ( ) ) ;
                 System . out . println ( "method version:" + methodInfo . version ( ) ) ;
                 System . out . println ( "method date:" + methodInfo . date ( ) ) ;
             }
         }
     } catch ( ClassNotFoundException e ) {
         e . printStackTrace ( ) ;
     }
}

以之前自定义的 MethodInfo 为例,利用 Target(这里是 Method)getAnnotation 函数得到 Annotation 信息,然后就可以调用 Annotation 的方法得到响应属性值

 

2 编译时 Annotation 解析

(1) 编译时 Annotation 指 @Retention 为 CLASS 的 Annotation,甴 apt(Annotation Processing Tool) 解析自动解析。需要做的
a. 自定义类集成自 AbstractProcessor
b. 重写其中的 process 函数
这块很多同学不理解,实际是 apt(Annotation Processing Tool) 在编译时自动查找所有继承自 AbstractProcessor 的类,然后调用他们的 process 方法去处理
(2) 假设之前自定义的 MethodInfo 的 @Retention 为 CLASS,解析示例如下:

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@SupportedAnnotationTypes ( { "cn.trinea.java.test.annotation.MethodInfo" } )
public class MethodInfoProcessor extends AbstractProcessor {
 
     @Override
     public boolean process ( Set < ? extends TypeElement > annotations , RoundEnvironment env ) {
         HashMap < String , String > map = new HashMap < String , String > ( ) ;
         for ( TypeElement te : annotations ) {
             for ( Element element : env . getElementsAnnotatedWith ( te ) ) {
                 MethodInfo methodInfo = element . getAnnotation ( MethodInfo . class ) ;
                 map . put ( element . getEnclosingElement ( ) . toString ( ) , methodInfo . author ( ) ) ;
             }
         }
         return false ;
     }
}

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

 

六、几个 Android 开源库 Annotation 原理简析

1 Annotation — Retrofit

(1) 调用

Java
1
2
@GET ( "/users/{username}" )
User getUser ( @Path ( "username" ) String username ) ;

(2) 定义

Java
1
2
3
4
5
6
7
@Documented
@Target ( METHOD )
@Retention ( RUNTIME )
@RestMethod ( "GET" )
public @interface GET {
   String value ( ) ;
}

从定义可看出 Retrofit 的 Get Annotation 是运行时 Annotation,并且只能用于修饰 Method
(3) 原理

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
private void parseMethodAnnotations ( ) {
     for ( Annotation methodAnnotation : method . getAnnotations ( ) ) {
     Class < ? extends Annotation > annotationType = methodAnnotation . annotationType ( ) ;
     RestMethod methodInfo = null ;
 
     for ( Annotation innerAnnotation : annotationType . getAnnotations ( ) ) {
         if ( RestMethod . class == innerAnnotation . annotationType ( ) ) {
             methodInfo = ( RestMethod ) innerAnnotation ;
             break ;
         }
     }
    ……
     }
}   

RestMethodInfo.java 的 parseMethodAnnotations 方法如上,会检查每个方法的每个 Annotation, 看是否被 RestMethod 这个 Annotation 修饰的 Annotation 修饰,这个有点绕,就是是否被 GET、DELETE、POST、PUT、HEAD、PATCH 这些 Annotation 修饰,然后得到 Annotation 信息,在对接口进行动态代理时会掉用到这些 Annotation 信息从而完成调用。 因为 Retrofit 原理设计到动态代理,这里只介绍 Annotation,具体原理分析请等待 Android 优秀开源项目实现原理解析 项目的完成

 

2 Annotation — Butter Knife

(1) 调用

Java
1
2
@InjectView ( R . id . user )
EditText username ;

(2) 定义

Java
1
2
3
4
5
@Retention ( CLASS )
@Target ( FIELD )
public @interface InjectView {
   int value ( ) ;
}

可看出 Butter Knife 的 InjectView Annotation 是编译时 Annotation,并且只能用于修饰属性
(3) 原理

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
@Override
public boolean process ( Set < ? extends TypeElement > elements , RoundEnvironment env ) {
     Map < TypeElement , ViewInjector > targetClassMap = findAndParseTargets ( env ) ;
 
     for ( Map . Entry < TypeElement , ViewInjector > entry : targetClassMap . entrySet ( ) ) {
         TypeElement typeElement = entry . getKey ( ) ;
         ViewInjector viewInjector = entry . getValue ( ) ;
 
         try {
             JavaFileObject jfo = filer . createSourceFile ( viewInjector . getFqcn ( ) , typeElement ) ;
             Writer writer = jfo . openWriter ( ) ;
             writer . write ( viewInjector . brewJava ( ) ) ;
             writer . flush ( ) ;
             writer . close ( ) ;
         } catch ( IOException e ) {
             error ( typeElement , "Unable to write injector for type %s: %s" , typeElement , e . getMessage ( ) ) ;
         }
     }
 
     return true ;
}

ButterKnifeProcessor.java 的 process 方法如上,编译时,在此方法中过滤 InjectView 这个 Annotation 到 targetClassMap 后,会根据 targetClassMap 中元素生成不同的 class 文件到最终的 APK 中,然后在运行时调用 ButterKnife.inject(x) 函数时会到之前编译时生成的类中去找。 这里只介绍 Annotation,具体原理分析请等待 Android 优秀开源项目实现原理解析 项目的完成

 

3 Annotation — ActiveAndroid

(1) 调用

Java
1
2
@Column ( name = Name" )
public String name ;

(2) 定义

Java
1
2
3
4
5
@Target ( ElementType . FIELD )
@Retention ( RetentionPolicy . RUNTIME )
public @interface Column {
  ……
}

可看出 ActiveAndroid 的 Column Annotation 是运行时 Annotation,并且只能用于修饰属性
(3) 原理

Java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Field idField = getIdField ( type ) ;
mColumnNames . put ( idField , mIdName ) ;
 
List <Field> fields = new LinkedList <Field> ( ReflectionUtils . getDeclaredColumnFields ( type ) ) ;
Collections . reverse ( fields ) ;
 
for ( Field field : fields ) {
     if ( field . isAnnotationPresent ( Column . class ) ) {
         final Column columnAnnotation = field . getAnnotation ( Column . class ) ;
         String columnName = columnAnnotation . name ( ) ;
         if ( TextUtils . isEmpty ( columnName ) ) {
             columnName = field . getName ( ) ;
         }
 
         mColumnNames . put ( field , columnName ) ;
     }
}

TableInfo.java 的构造函数如上,运行时,得到所有行信息并存储起来用来构件表信息。

这里原理都只介绍 Annotation,具体原理分析请等待 Android 优秀开源项目实现原理解析 项目的完成

 

最后留下一个小问题:如何判断一个 Annotation 是运行时还是编译时生效以及如何快速找到它的解析代码

 

前面的示例代码运行结果应该是 10 而不是 1,这个示例代码程序实际想说明的是标记型注解 Override 的作用,为 equals 方法加上 Override 注解就知道 equals 方法的重载是错误的,参数不对

马孔多
粉丝 0
博文 8
码字总数 3650
作品 0
浦东
程序员
私信 提问
加载中
请先登录后再评论。
Java Android 注解(Annotation) 及几个常用开源项目注解原理简析

不少开源库(ButterKnife、Retrofit、ActiveAndroid等等)都用到了注解的方式来简化代码提高开发效率。 本文简单介绍下 Annotation 示例、概念及作用、分类、自定义、解析,并对几个 Android ...

Trinea
2014/10/17
127
0
Java开发神器Lombok的使用与原理(转)

博主推荐 : 掘金是一个面向程序员的的技术社区,从 后端到架构,从Spring教程到开源库,无论是入门还是进阶,来掘金你不会错过后端开发的任何一个技术干货。 在面向对象编程中必不可少需要在...

osc_8tcnyc1i
2018/05/23
11
0
Java开发神器Lombok的使用与原理

在面向对象编程中必不可少需要在代码中定义对象模型,而在基于Java的业务平台开发实践中尤其如此。相信大家在平时开发中也深有感触,本来是没有多少代码开发量的,但是因为定义的业务模型对象...

消失er
2018/05/16
0
0
Lombok的使用与原理

在面向对象编程中必不可少需要在代码中定义对象模型,而在基于Java的业务平台开发实践中尤其如此。相信大家在平时开发中也深有感触,本来是没有多少代码开发量的,但是因为定义的业务模型对象...

osc_3l8mmxug
2019/09/17
2
0
2017 Android 面试题 [ 基础与细节 ]

感谢@chuyao抛出的这些问题,平时业务代码写多了,很多基础的东西变得含糊不清了,这次裸辞出来找工作确实没有之前顺利,顺便求上海Android开发的坑。 我自己整理了些答案,不对或者不妥的地...

Sun‘刺眼的博客
2017/03/30
0
0

没有更多内容

加载失败,请刷新页面

加载更多

Java中C ++ Pair 的等价物是什么? - What is the equivalent of the C++ Pair in Java?

问题: Is there a good reason why there is no Pair<L,R> in Java? 有没有一个很好的理由说明Java中没有Pair<L,R> ? What would be the equivalent of this C++ construct? 这个C ++构造的......

富含淀粉
8分钟前
10
0
在Swift中将字符串拆分成数组? - Split a String into an array in Swift?

问题: Say I have a string here: 说我在这里有一个字符串: var fullName: String = "First Last" I want to split the string base on white space and assign the values to their res......

javail
38分钟前
12
0
中国饭店协会数据表明

记者了解到,中国饭店协会数据表明,2018年全国餐饮收入42716亿元,同比增长9.5%.根据国家统计局数据显示,截至2017年底,限额以上餐饮行业的从业人数达到2232万人,巨大的餐饮市场背后,餐饮行业的...

asd369
今天
35
0
OSChina 周六乱弹 —— 日本的丧尸光天化日之下都开始……

Osc乱弹歌单(2020)请戳(这里) 【今日歌曲】 @薛定谔的兄弟 :分享洛神有语创建的歌单「我喜欢的音乐」: 《風の手枕》- 増田俊郎 手机党少年们想听歌,请使劲儿戳(这里) @码界农民工 :...

小小编辑
今天
55
0
Hacker News 简讯 2020-07-11

更新时间: 2020-07-11 04:01 Investors say agroforestry is climate friendly and also profitable - (mongabay.com) 投资者表示,农林复合林对气候友好,而且也有利可图 得分:86 | 评论:52...

FalconChen
今天
163
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部