Android注解(annotation)介绍及其应用

• 自定义注解

• 注解的应用：反射

• 注解的应用：APT

• 其它

介绍

============================================================

Annotation，又叫注解，是附加在代码上的元信息（用于标记属性）。

Annotation适用于IDE工具在编译、运行时对其解析和使用，起到配置的作用。

我们最常见的Annotation：

@Override

public void onCreate() {

super.onCreate();

}

Override表明这个方法是一个重写的方法，需要IDE协助检查这个方法是否是父类的方法，如果不是则会报错提醒。如果不加Override，这个方法名不是父类的话，IDE也不会报错提醒。

从上面Override的例子我们可以看到，annotation更像是一个标签，它不仅仅可以附着在方法上面，还可以在包、类、字段、方法的参数、局部变量等上面进行标记。

自定义注解

===============================================================

还是用Override这个注解为例，我们看下源码：

@Target(ElementType.METHOD)

@Retention(RetentionPolicy.SOURCE)

public @interface Override {

}

这里要提到元注解的概念。什么是元注解？元注解就是注解上的注解，也就是注解上的标签。比如我们在自定义注解的时候，@Target、@Retention这些都是元注解。

那元注解有什么用的呢？我看不妨来看一下元注解的作用：

@Retention：注解生命周期范围。

@Target：注解对象的作用范围。

@Inherited：@Inherited标明子类是否可以继承该父类的注解。

@Documented：javadoc工具的文档化。

@Retention的值：

@Retention(RetentionPolicy.SOURCE) ：注释仅存在源码中，class文件中不包含；

@Retention(RetentionPolicy.CLASS)：默认策略，class文件中包含，运行时遗弃；

@Retention(RetentionPolicy.RUNTIME)：class文件包含，运行时通过反射也可以获得；

@Target有很多值，就像上面提到的，注释不仅可以用在方法上，也可以用在包、类、字段等等其它上面。像@Override的@Target(ElementType.METHOD)标明注解的作用范围是方法。

注解的应用：反射

==================================================================

通过反射获取注解是一个很常用的方法，但是需要注意的是，如果通过反射获取Annotation，那么这个Annotation的@Retention策略需要是RUNTIME的。这样就导致了反射获取注解应用范围有限。

定义一个@ByString的注解：

@Target(ElementType.FIELD)

@Retention(RetentionPolicy.RUNTIME)

public @interface ByString {

int value();

}

在源码中标记这个注解：

@ByString(R.string.annotation_reflection)

private String text;

通过反射获取field：

Field[] fields = clazz.getDeclaredFields();

if (fields != null) {

for (Field field : fields) {

…

}

}

找到这个注解：

ByString stringById = field.getAnnotation(ByString.class);

if (stringById != null) {

int stringId = stringById.value();

}

最后通过field的set方法进行赋值。

注解的应用：APT

===================================================================

APT(Annotation Processing Tool)，它可以对源码进行扫描检测，找出其中的Annotation，并且自动生成相应的代码，并且将这些代码保存在额外的文件中(.class文件)，最终这些.class文件一并参与apk的编译。

一个完整的APT包含：

1、AbstractProcessor：注解处理器，这是一个抽象类，一般需要自己实现一个。

public class TagBinderProcessor extends AbstractProcessor { …}

2、处理器注册（AutoService）：

@AutoService(Processor.class)

public class TagBinderProcessor extends AbstractProcessor { …}

我们自定义了一个叫TagBinderProcessor的注解处理器，需要通过@AutoService注册一下。

3、代码自动生成（javaPoet）

根据注解，我们需要生成代码。而 JavaPoet 就是用来生成 Java 代码的一个 Java Library。

使用的时候需要引入：

implementation ‘com.squareup:javapoet:1.10.0’

我们看一段JavaPoet用法：

class AnnotatedClass {

private ArrayList mFields;

AnnotatedClass() {

mFields = new ArrayList<>();

}

void addField(BindTagField field) {

mFields.add(field);

}

最后

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

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

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

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

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

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

YngsMC2-1715112866762)]

[外链图片转存中…(img-kgMrN3AB-1715112866762)]

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

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

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！