转载

apt代码生成之实践入门

现在 Android 主流库中使用 apt 的越来越多，如Dagger2，ButterKnife，DBflow等。不研究一下其怎么玩的，心里实在是不舒服斯基，所以就有了这篇apt代码简单生成的文章。文章的末尾，会附上一些关于注解的基础知识，有兴趣的童鞋可以再去看看。

Annotation库-定义注解

首先，我们得需要新建一个名称为annotation的Java Library。这里简单的建一个 @interfact 的注解类即可。如下：

@Target(ElementType.TYPE) @Retention(RetentionPolicy.CLASS) public @interface Test {     String value(); }

可以看到的是，这是编译时期的注解，主要作用于Class。之后，在调用的地方就是需要使用我们的这个注解。

Compiler库-注解处理器

1.使用库引入

这里，也使用的是Java Library，我们把报名定为 compiler ，先定义gradle文件：

apply plugin: 'java'  sourceCompatibility = 1.7 targetCompatibility = 1.7  dependencies {     compile 'com.google.auto.service:auto-service:1.0-rc2'     compile 'com.squareup:javapoet:1.7.0'     compile project(':annotation') }

代码中，引入两个库， AutoService 主要的作用是注解 processor 类，并对其生成 META-INF 的配置信息。

JavaPoet 这个库的主要作用就是帮助我们通过类调用的形式来生成代码。

2. 定义Processor类

建立一个名称为 TestProcessor 的类，如下：

@AutoService(Processor.class) public class TestProcessor extends AbstractProcessor {      @Override     public Set<String> getSupportedAnnotationTypes() {         return Collections.singleton(Test.class.getCanonicalName());     }      @Override     public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {         return false;     } }

其中要注意的是使用 AutoSerivce 的注解，这样就不用再手动配置 META-INF文件了。方法 getSupportedAnnotationTypes 则是定义我们针对生成的注解类，方法 process 则是我们的重头戏，其中则是我们生成代码的主要逻辑之处：

@Override public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {   Set<? extends Element> set = roundEnv.getElementsAnnotatedWith(Test.class);   for (Element element : set) {     if (element.getKind() != ElementKind.CLASS) {       processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR, "only support class");     }     MethodSpec main = MethodSpec.methodBuilder("main")       .addModifiers(Modifier.PUBLIC, Modifier.STATIC)       .returns(void.class)       .addParameter(String[].class, "args")       .addStatement("$T.out.println($S)", System.class, "Hello, JavaPoet!")       .build();      TypeSpec helloWorld =       TypeSpec.classBuilder("HelloWorld").addModifiers(Modifier.PUBLIC, Modifier.FINAL).addMethod(main).build();     JavaFile javaFile = JavaFile.builder("com.lighters.apt", helloWorld).build();      try {       javaFile.writeTo(processingEnv.getFiler());     } catch (IOException e) {       e.printStackTrace();     }   }   return false; }

这里简单使用 JavaPoet 文档中的第一个example, 生成一个简单的HelloWorld类。大家可自己行去查看JavaPoet的更多用法，支持各种姿势生成Java的代码，并与 Processor 完美契合。

代码调用

准备工作都完成之后，接下来就在我们的主目录 app 下面，通过添加注解，来查看我们的代码生成逻辑。

1.添加依赖

在根目录的 build.gradle 文件中的 dependencies 节点下面添加如下代码：

classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'

app的 build.gradle 中添加如下代码：

apply plugin: 'com.neenbedankt.android-apt' dependencies {     compile project(':annotation')     apt project(':compiler') }

2.添加注解

这里，就偷一个小懒，在 MainActivity 上，添加注解 Test ，格式如下：

@Test("haha") public class MainActivity extends AppCompatActivity { }

3.代码生成

注意，这里定义的注解为编译期的注解，所以代码的生成，只需要通过执行 Rebuild 即可。执行完成之后，在app的 build/generated/source/apt 目录下，即可看到咱们的代码，如图: apt代码生成之实践入门

总结

apt代码的生成是定义编译期的注解，再通过继承 Proccesor 实现代码生成逻辑，实现了编译期生成代码的逻辑。相对于在运行期通过反射来说，提高了程序的运行速度。这里只是简单引导大家搭建自己的apt处理器，更多的内容期待大家各自玩出花来。

学习资料

附上一篇标准的编译期代码生成，以及trinea关于annotation的详细介绍。

Annotation实战【自定义AbstractProcessor】
Java Annotation 及几个常用开源项目注解原理简析

另外，使用apt的代码库 Dagger2 , Butterknife 大家可自行深入研究了。

原文 http://alighters.com/blog/2016/05/10/apt-code-generate/

正文到此结束

所属分类：编程技术

本文标签： 文章 db Google 总结 ACE classpath 开源项目 final http 编译 IDE dependencies src Service java UI value lib java annotation 目录配置 Collections 处理器 cat Android build Trinea tar App example message 代码开源
版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
本文海报： 生成海报一生成海报二

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

apt代码生成之实践入门

Annotation库-定义注解

Compiler库-注解处理器

1.使用库引入

2. 定义Processor类

代码调用

1.添加依赖

2.添加注解

3.代码生成

总结

学习资料

热门推荐

相关文章

说给你听

本文目录

随机标签

书籍教程

近期评论

网站信息

其他链接

关于本站

问题交流