Android 编译时注解 —— 语法详解

这样在做代码生成时，不需要再单独考虑每一个监听注解，只需要处理@ListenerClass就OK。如 @interface OnItemClick 等。

@Target(METHOD)

@Retention(CLASS)

@ListenerClass(

targetType = “android.widget.AdapterView<?>”,

setter = “setOnItemClickListener”,

type = “android.widget.AdapterView.OnItemClickListener”,

method = @ListenerMethod(

name = “onItemClick”,

parameters = {

“android.widget.AdapterView<?>”,

“android.view.View”,

“int”,

“long”

}

)

)

public @interface OnItemClick {

/** View IDs to which the method will be bound. */

@IdRes int[] value() default { View.NO_ID };

}

---

自定义注解

---

一个简单的自定义注解例子

@Documented()

// 表示是基于编译时注解的

@Retention(RetentionPolicy.CLASS)

// 表示可以作用于成员变量，类、接口

@Target({ElementType.FIELD, ElementType.TYPE})

public @interface Seriable {

}

指定默认值

@Documented()

// 表示是基于编译时注解的

@Retention(RetentionPolicy.CLASS)

// 表示可以作用于成员变量，类、接口

@Target({ElementType.FIELD, ElementType.TYPE})

public @interface Seriable {

int id();

String name() default “test”;

}

//使用

@Seriable(id = 1) //name有默认值可以不写

class Test{

}

关于怎样自定义一个注解，可以参看这一篇博客，Android 自定义编译时注解1 - 简单的例子

---

处理器类Processor编写

---

自定义注解后，需要编写Processor类处理注解。Processor 继承自 AbstractProcessor 的类。我们主要需要处理以下连个方法。

• public Set getSupportedAnnotationTypes()

• public abstract boolean process(Set<? extends TypeElement >annotations，RoundEnvironment roundEnv);

getSupportedAnnotationTypes 方法

重写 getSupportedAnnotationTypes 方法：告知Processor哪些注解需要处理。返回一个Set集合，集合内容为 自定义注解的包名+类名。

建议项目中这样编写：

@Override

public Set getSupportedAnnotationTypes() {

Set types = new LinkedHashSet<>();

//需要全类名

types.add(Seriable.class.getCanonicalName());

types.add(Println.class.getCanonicalName());

return types;

}

另外如果注解数量很少的话，可以通过另一种方式实现：

//在只有一到两个注解需要处理时，可以这样编写：

@SupportedAnnotationTypes({“com.example.Seriable”})

@SupportedSourceVersion(SourceVersion.RELEASE_7)

public class JsonProcessor extends AbstractProcessor {

}

process 方法

process 方法，这个方法是所有方法中最关键的一个方法，他用来处理注解的相关信息，比如提取注解的信息，存进 map 集合或者生成代码等。

@Override

public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {

return false;

}

public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {

// 第一步，根据我们自定义的注解拿到 elememts set 集合

Set<? extends Element> elememts = roundEnv.getElementsAnnotatedWith(Seriable.class);

TypeElement typeElement;

VariableElement variableElement;

// 第二步： 根据 element 的类型做相应的处理，并存进 map 集合

for (Element element : elememts) {

ElementKind kind = element.getKind();

// 判断该元素是否为类

if (kind == ElementKind.CLASS) {

typeElement = (TypeElement) element;

// 判断该元素是否为成员变量

} else if (kind == ElementKind.FIELD) {

variableElement = (VariableElement) element;

}

}

return true;

}

Element

---

元素，虽有通过注解取得的元素都以 Element 等待处理,它的具体类型与我们通过 @Target 来标记的具有一定的联系。

官方的解释是这样的：

Represents a program element such as a package, class, or method.Each element represents a static, language-level construct

(and not, for example, a runtime construct of the virtual machine)

表示程序元素如包、类或者方法。每个元素代表一个静态语言级构造(例如,而不是运行时构建的虚拟机）

例如：

// 第一步，根据我们自定义的注解拿到 elememts set 集合

Set<? extends Element> elememts = roundEnv.getElementsAnnotatedWith(Seriable.class);

TypeElement typeElement;

VariableElement variableElement;

// 第二步： 根据 element 的类型做相应的处理，并存进 map 集合

for (Element element : elememts) {

ElementKind kind = element.getKind();

// 判断该元素是否为类

if (kind == ElementKind.CLASS) {

typeElement = (TypeElement) element;

// 判断该元素是否为成员变量

} else if (kind == ElementKind.FIELD) {

variableElement = (VariableElement) element;

}

}

Element 的子类

Element 的子类有：

• ExecutableElement

表示某个类或接口的方法、构造方法或初始化程序（静态或实例），包括注释类型元素。

对应@Target(ElementType.METHOD) @Target(ElementType.CONSTRUCTOR)

• PackageElement;

表示一个包程序元素。提供对有关包极其成员的信息访问。

对应@Target(ElementType.PACKAGE)

• TypeElement;

表示一个类或接口程序元素。提供对有关类型极其成员的信息访问。

对应@Target(ElementType.TYPE)

注意：枚举类型是一种类，而注解类型是一种接口。

• TypeParameterElement;

表示一般类、接口、方法或构造方法元素的类型参数。

对应@Target(ElementType.PARAMETER)

• VariableElement;

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

最后

其实Android开发的知识点就那么多，面试问来问去还是那么点东西。所以面试没有其他的诀窍，只看你对这些知识点准备的充分程度。so，出去面试时先看看自己复习到了哪个阶段就好。

当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯，一定要学会把好的东西，归纳整理，然后系统的消化吸收，这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西，我觉得最没有价值的。就好比你给我一张扑克牌，我只会觉得它是一张废纸，但如果你给我一副扑克牌，它便有了它的价值。这和我们收集资料就要收集那些系统化的，是一个道理。

网上学习 Android的资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。希望这份系统化的技术体系对大家有一个方向参考。

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

面试时先看看自己复习到了哪个阶段就好。

当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯，一定要学会把好的东西，归纳整理，然后系统的消化吸收，这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西，我觉得最没有价值的。就好比你给我一张扑克牌，我只会觉得它是一张废纸，但如果你给我一副扑克牌，它便有了它的价值。这和我们收集资料就要收集那些系统化的，是一个道理。

[外链图片转存中…(img-YMXghdpl-1713195138181)]

网上学习 Android的资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。希望这份系统化的技术体系对大家有一个方向参考。

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！