HarmonyOS技术社区 · 2021年05月07日

安卓to鸿蒙系列:ButterKnife(一)

目录:
1、基础知识
2、写一个乞丐版的ButterKnife
3、总结

本文是关于ButterKnife的移植的第一篇:

先介绍基础知识,理解apt是什么,最终输出一个乞丐版BufferKnife注入工具。

这是读懂BufferKnife源码的基础。

第二篇占坑:具体讲解BufferKnife的移植。

基础知识

apt技术的实际应用:

  • Android Databinding绑定view
  • ButterKnife绑定view
  • Dagger2注入变量
  • ARouter生成路由表

真的好多,很重要。apt就是生产力工具!

什么是apt?

通俗讲:apt就是javac对外开放的一个插件,使javac在编译期间获取注解(Annotation),并做出相应的处理(多数都是生成一些java代码)。



从上图可以看出apt处理的是 java源文件 ,在编译期介入。

与之对比的是asm之类的工具,处理的是字节码文件,在编译后期介入。

apt与javac的约定

apt与javac约定在META-INF/services/javax.annotation.processing.Processor文件中注册apt插件。这样apt就参与到javac的编译过程中了。

写一个乞丐版BufferKnife

不想看文字,直接看源码,点击 https://gitee.com/andych008/aptDemo

初始代码fork自 https://github.com/LiMubai2017/aptDemo ,先对作者表示感谢。

    • -

乞丐版BufferKnife作为一款view注入工具,主要干了3件事,

  1. 解析注解
  2. 处理注解(生成模板类文件)
  3. 通过模板类注入view对象

第0步:准备工作

先定义注解BindView,被@BindView标记的变量会被注入。

一般注解都定义在一个单独的module(如取名apt-annotation),因为它会被apt-compiler和apt-api都依赖,属于公共代码。

apt-compiler是apt的主要代码所在,完成注解的解析、模板文件的生成。

apt-api则是对外的工具类,供用户使用,完成注入操作。

app是demo,其中定义了

@BindView(value = ResourceTable.Id_text_helloworld)
public Text testTextView;

第一步:解析注解

在apt-compiler中定义类BindViewProcessor继承javax.annotation.processing.AbstractProcessor,实现其中的getSupportedAnnotationTypes()该方法注册要解析的注解。

第二步:处理注解(生成模板文件)

BindViewProcessor中实现process()方法,处理注解。

先理解javax.lang.model.element.Elementjavax.lang.model.type.TypeMirror,参考这里 有详细的解释。

简单讲:

Element是描述java语言元素的类,比如包、类、变量、参数等。

TypeMirror是描述Element类型的类,比如各种基本类型、数组、类等。

很绕,只有多用才能真正理解。比如:demo中testTextView就是VariableElement元素类型

TypeElement enclosingElement = (TypeElement) variableElement.getEnclosingElement();//获取代表MainAbility的TypeElement

String field = variableElement.getSimpleName().toString();//testTextView
TypeMirror typeMirror = variableElement.asType();//ohos.agp.components.Text

通过log()方法,可以使用Messager打日志,验证我们的理解。

log(String.format("element : (%s) %s ", element.getKind(), element));
log(String.format("bind : (%s) %s <--> id = %d", typeMirror, field, id));
输出日志:
注: element : (FIELD) testTextView 
注: bind : (ohos.agp.components.Text) testTextView <--> id = 16777222

generateCodeByPoet()方法中,使用javapoet生成模板代码MainAbility$$Autobind.java`(文件路径`app/build/generated/source/annotation/debug/com/example/apt_demo/MainAbility$$Autobind.java

关于javapoet的使用,直接看官方文档吧:https://github.com/square/javapoet

解释一下下面这段代码,让大家对javapoet有一直观的认识

MethodSpec.Builder injectMethod = MethodSpec.methodBuilder("inject")//生成一个方法,方法名是inject
        .addAnnotation(Override.class)//给方法加上"Override.class"注解
        .addModifiers(Modifier.PUBLIC)//给方法加上访问控制符
        .addParameter(Object.class, "target")//给方法加上参数
        .addStatement("$T substitute = ($T)target", className, className);//在方法体内定义一条语名

上面的代码生成下面的代码(我用java代码生成java代码,这就是javapoet干的事情):

@Override
public void inject(Object target) {
  MainAbility substitute = (MainAbility)target;
}

看完上面这一坨,你如果觉得难。请用JavaWriter生成java文件。你就会觉得javapoet真香。

第三步:通过模板类注入view对象

在apt-api中,我们定义一个AutoBind.java类封装对模板类MainAbility$$Autobind.java的操作。

按照模板类的命名规则xxx$$Autobind`,通过反射实例化出`MainAbility$$Autobind.java,调用 其中的inject方法,完成view的注入。

总结

apt只是一个工具,在这套工具框架下,怎么处理注解才是难点。

BufferKnife和我们的“乞丐版BufferKnife”本质上没有区别。除了注入view,还支持事件绑定、增量编译。

作者:没用的喵叔
想了解更多内容,请访问51CTO和华为合作共建的鸿蒙社区:https://harmonyos.51cto.com

21_9.jpg

推荐阅读
关注数
2947
内容数
446
华为鸿蒙相关技术,活动及资讯,欢迎关注及加入创作
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息