前言:随着一些如ButterKnife,dagger等的开源注解框架的流行,APT的概念也越来越被熟知。这篇文章将介绍APT的概念,以及我们怎么利用APT来自定义一个注解。
一,APT的介绍 APT英文全称:Android annotation process tool是一种处理注释的工具,它对源代码文件进行检测找出其中的Annotation,使用Annotation进行额外的处理。 Annotation处理器在处理Annotation时可以根据源文件中的Annotation生成额外的源文件和其它的文件(文件具体内容由Annotation处理器的编写者决定),APT还会编译生成源文件和原来的源文件,将它们一起生成class文件。简言之:APT可以把注解,在编译时生成代码。 二,APT的处理要素 注解处理器(AbstractProcess)+代码处理(javaPoet)+处理器注册(AutoService)+apt 三,使用APT来处理annotation的流程 1.定义注解(如@automain) 2.定义注解处理器 3.在处理器里面完成处理方式,通常是生成java代码。 4.注册处理器 5.利用APT完成如下图的工作内容。
四,使用APT的简单项目 1.新建项目APTProject 2.在项目对应的build.gradle文件中添加APT工具依赖。位置如下所示:dependencies {
classpath 'com.android.tools.build:gradle:2.2.3'
//添加APT依赖
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
复制代码
3.在对应的module的build.gradle文件中添加下面的依赖:
apply plugin: 'com.android.application'
//添加APT plugin
apply plugin: 'com.neenbedankt.android-apt'
复制代码
4.创建java Library Module,命名为apt-lib,并把这个module引入到app中。
编写如下的类:@Target(ElementType.TYPE) //作用在类上
@Retention(RetentionPolicy.RUNTIME)//存活时间
public @interface AutoCreate {
}
复制代码
5.再创建一个java Library Module,命名为apt-process,并把这个module引入到app中。
6.编写下面的类来处理注解package com.wjstudio;
import com.example.AutoCreat;
import com.google.auto.service.AutoService;
import com.squareup.javapoet.JavaFile;
import com.squareup.javapoet.MethodSpec;
import com.squareup.javapoet.TypeSpec;
import java.io.IOException;
import java.util.Collections;
import java.util.Set;
import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.Processor;
import javax.annotation.processing.RoundEnvironment;
import javax.lang.model.element.Modifier;
import javax.lang.model.element.TypeElement;
/**
* 注解处理器
* 完成注解的处理
* 1.处理哪个注解
* 2.如何处理
*/
//注册处理器,告知APT,AutoCrate是由TestProcess处理@AutoService(Processor.class)public class TestProcess extends AbstractProcessor {
@Override
public Set getSupportedAnnotationTypes() {
//定义需要处理的注解
return Collections.singleton(AutoCreat.class.getCanonicalName());
}
@Override
public boolean process(Set extends TypeElement> annotations, RoundEnvironment roundEnv) {
//如何处理该注解
/*
* hello.java
public final class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, JavaPoet!");
}
}
*/
//文件
//文件内容--java代码生成工具javapoet
//MethodSpec:定义方法
//TypeSec:定义类
//JavaFile:生成.java文件
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.songwenju.aptproject", helloWorld)
.build();
try {
javaFile.writeTo(processingEnv.getFiler());
} catch (IOException e) {
e.printStackTrace();}
return false;
}
}
复制代码
需要再改lib中引入
compile 'com.squareup:javapoet:1.8.0'
compile 'com.google.auto.service:auto-service:1.0-rc2'
复制代码
这里为了方便解释加了汉字,在AndroidStudio中编译的时候不能加汉字。 7.在使用注解的地方添加依赖
compile project(':apt-process')
apt project(':apt-process')
复制代码
8.使用生成的注解 在app Module对应的 MainActivity上加上注解,如下,编译之后可以看到生成的java类。
@AutoCreatpublic
class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
复制代码
Rebuild之后,生成如下源代码:
至此完成了Apt的介绍和简单的应用。 例子详见 github.com/songwenju/A…,如果对您有帮助,欢迎star和fork。版权声明:本文为博主原创文章,转载请注明出处。