//获取子Element的集合
List<? extends Element> getEnclosedElements();
}
二、TypeMirror
Element
有一个asType()
方法用来返回TypeMirror
。TypeMirror
表示 Java 编程语言中的类型。这些类型包括基本类型、声明类型(类和接口类型)、数组类型、类型变量和 null 类型。还可以表示通配符类型参数、executable 的签名和返回类型,以及对应于包和关键字 void
的伪类型。我们一般用TypeMirror进行类型判断。如下段代码,用来比较元素所描述的类型是否是Activity的子类。
/**
- 类型相关工具类
/
private Types typeUtils;
/* - 元素相关的工具类
*/
private Elements elementUtils;
private static final String ACTIVITY_TYPE = “android.app.Activity”;
private boolean isSubActivity(Element element){
//获取当前元素的TypeMirror
TypeMirror elementTypeMirror = element.asType();
//通过工具类Elements获取Activity的Element,并转换为TypeMirror
TypeMirror viewTypeMirror = elementUtils.getTypeElement(ACTIVITY_TYPE).asType();
//用工具类typeUtils判断两者间的关系
return typeUtils.isSubtype(elementTypeMirror,viewTypeMirror)
}
三、一个简单的ButterKnife
这一节我们通过编写一个简单的ButterKnife
来介绍一下如何编写一个APT框架。APT应该是编译期插桩最简单的一种技术,通过三步就可以完成。
- 定义编译期注解。
我们新增一个Java Library Module命名为apt_api
,编写注解类BindView。
@Retention(RetentionPolicy.Class)
@Target(ElementType.FIELD)
public @interface BindView {
}
这里简单介绍一下RetentionPolicy
。RetentionPolicy
是一个枚举,它的值有三种:SOURCE、CLASS、RUNTIME。
- SOURCE:不参与编译,让开发者使用。
- CLASS:参与编译,运行时不可见。给编译器使用。
- RUNTIME:参与编译,运行时可见。给编译器和JVM使用。
- 定义注解处理器。
同样,我们需要新增一个Java Library Module命名为apt_processor
。
我们需要引入两个必要的依赖:一个是我们新增的module apt_annotation
,另一个是google的com.google.auto.service:auto-service:1.0-rc3
(以下简称auto-service
)。
implementation project(‘:apt_api’)
api ‘com.google.auto.service:auto-service:1.0-rc3’
新增一个类 ButterKnifeProcessor
,继承 AbstractProcessor
。
@AutoService(Processor.class)
public class ButterKnifeProcessor extends AbstractProcessor {
/**
- 元素相关的工具类
/
private Elements elementUtils;
/* - 文件相关的工具类
/
private Filer filer;
/* - 日志相关的工具类
/
private Messager messager;
/* - 类型相关工具类
*/
private Types typeUtils;
@Override
public Set getSupportedAnnotationTypes() {
return Collections.singleton(BindView.class.getCanonicalName());
}
@Override
public SourceVersion getSupportedSourceVersion() {
return SourceVersion.RELEASE_7;
}
@Override
public synchronized void init(ProcessingEnvironment processingEnvironment) {
super.init(processingEnvironment);
elementUtils = processingEnv.getElementUtils();
filer = processingEnv.getFiler();
messager = processingEnv.getMessager();
typeUtils = processingEnv.getTypeUtils();
}
@Override
public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
return false;
}
}
auto-service
为我们简化了定义注解处理器的流程。@AutoService
是就是由auto-service
提供的,其作用是用来告诉编译器我们定义的ButterKnifeProcessor
是一个编译期注解处理器。这样在编译时ButterKnifeProcessor
才会被调用。
我们还重写了AbstractProcessor提供的四个方法:getSupportedAnnotationTypes
、getSupportedSourceVersion
、init
、process
。
getSupportedAnnotationTypes
表示处理器可以处理哪些注解。这里返回的是我们之前定义的BindView。除了重写方法之外,还可用通过注解来实现。
@SupportedAnnotationTypes(value = {“me.zhangkuo.apt.annotation.BindView”})
getSupportedSourceVersion
表示处理器可以处理的Java版本。这里我们采用最新的JDK版本就可以了。同样,我们也可以通过注解来实现。
@SupportedSourceVersion(value = SourceVersion.latestSupported())
-
init
方法主要用来做一些准备工作。我们一般在这里初始化几个工具类。上述代码我们初始了与元素相关的工具类elementUtils
、与日志相关的工具类messager
、与文件相关的filer
以及与类型相关工具类typeUtils
。我们接下来会看到process
主要就是通过这几个类来生成代码的。 -
process
用来完成具体的程序写代码功能。在具体介绍process
之前,请允许我先推荐一个库:javapoet。javapoet
是由神奇的square
公司开源的,它提供了非常人性化的api,来帮助开发者生成.java源文件。它的README.md
文件为我们提供了丰富的例子,是我们学习的主要工具。
private Map<TypeElement, List> elementPackage = new HashMap<>();
private static final String VIEW_TYPE = “android.view.View”;
private static final String VIEW_BINDER = “me.zhangkuo.apt.ViewBinding”;
@Override
public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
if (set == null || set.isEmpty()) {
return false;
}
elementPackage.clear();
Set<? extends Element> bindViewElement = roundEnvironment.getElementsAnnotatedWith(BindView.class);
//收集数据放入elementPackage中
collectData(bindViewElement);
//根据elementPackage中的数据生成.java代码
generateCode();
return true;
}
private void collectData(Set<? extends Element> elements){
Iterator<? extends Element> iterable = elements.iterator();
while (iterable.hasNext()) {
Element element = iterable.next();
TypeMirror elementTypeMirror = element.asType();
//判断元素的类型是否是View或者是View的子类型。
TypeMirror viewTypeMirror = elementUtils.getTypeElement(VIEW_TYPE).asType();
if (typeUtils.isSubtype(elementTypeMirror, viewTypeMirror) || typeUtils.isSameType(elementTypeMirror, viewTypeMirror)) {
//找到父元素,这里认为是@BindView标记字段所在的类。
TypeElement parent = (TypeElement) element.getEnclosingElement();
//根据parent不同存储的List中
List parentElements = elementPackage.get(parent);
if (parentElements == null) {
parentElements = new ArrayList<>();
elementPackage.put(parent, parentElements);
}
parentElements.add(element);
}else{
throw new RuntimeException(“错误处理,BindView应该标注在类型是View的字段上”);
}
}
}
private void generateCode(){
Set<Map.Entry<TypeElement,List>> entries = elementPackage.entrySet();
Iterator<Map.Entry<TypeElement,List>> iterator = entries.iterator();
while (iterator.hasNext()){
Map.Entry<TypeElement,List> entry = iterator.next();
//类元素
TypeElement parent = entry.getKey();
//当前类元素下,注解了BindView的元素
List elements = entry.getValue();
//通过JavaPoet生成bindView的MethodSpec
MethodSpec methodSpec = generateBindViewMethod(parent,elements);
String packageName = getPackage(parent).getQualifiedName().toString();
ClassName viewBinderInterface = ClassName.get(elementUtils.getTypeElement(VIEW_BINDER));
String className = parent.getQualifiedName().toString().substring(
packageName.length() + 1).replace(‘.’, ‘$’);
ClassName bindingClassName = ClassName.get(packageName, className + “_ViewBinding”);
try {
//生成 className_ViewBinding.java文件
JavaFile.builder(packageName, TypeSpec.classBuilder(bindingClassName)
.addModifiers(PUBLIC)
.addSuperinterface(viewBinderInterface)
.addMethod(methodSpec)
.build()
).build().writeTo(filer);
} catch (IOException e) {
e.printStackTrace();
}
}
}
private MethodSpec generateBindViewMethod(TypeElement parent,List elementList) {
ParameterSpec.Builder parameter = ParameterSpec.builder(TypeName.OBJECT, “target”);
MethodSpec.Builder bindViewMethod = MethodSpec.methodBuilder(“bindView”);
bindViewMethod.addParameter(parameter.build());
bindViewMethod.addModifiers(Modifier.PUBLIC);
bindViewMethod.addStatement(“
T
t
e
m
p
=
(
T temp = (
Ttemp=(T)target”,parent,parent);
for (Element element :
elementList) {
int id = element.getAnnotation(BindView.class).value();
bindViewMethod.addStatement(“temp.
N
=
t
e
m
p
.
f
i
n
d
V
i
e
w
B
y
I
d
(
N = temp.findViewById(
N=temp.findViewById(L)”, element.getSimpleName().toString(), id);
}
return bindViewMethod.build();
}
process的
代码比较长,但是它的逻辑非常简单看,主要分为收集数据和生成代码两部分。我为关键的地方都加了注释,就不再详细解释了。到这里我们基本上完成了注解器的编写工作。
- 使用注解
在build.gradle中引入我们定义的注解和注解处理器。
implementation project(‘:apt_api’)
annotationProcessor project(“:apt_processor”)
应用注解
结尾
好了,今天的分享就到这里,如果你对在面试中遇到的问题,或者刚毕业及工作几年迷茫不知道该如何准备面试并突破现状提升自己,对于自己的未来还不够了解不知道给如何规划,可以来看看同行们都是如何突破现状,怎么学习的,来吸收他们的面试以及工作经验完善自己的之后的面试计划及职业规划。
这里放上一部分我工作以来以及参与过的大大小小的面试收集总结出来的一套进阶学习的视频及面试专题资料包,主要还是希望大家在如今大环境不好的情况下面试能够顺利一点,希望可以帮助到大家~
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
进阶学习的视频及面试专题资料包*,主要还是希望大家在如今大环境不好的情况下面试能够顺利一点,希望可以帮助到大家~
[外链图片转存中…(img-1SaUeNwC-1714563872884)]
[外链图片转存中…(img-beNtb5fm-1714563872891)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!