在使用編譯時注解時,需要在編譯期間對注解進行處理召娜,在這里我們沒辦法影響程序的運行邏輯惊楼,但我們可以進行一些需處理秸讹,比如生成一些功能性代碼來輔助程序的開發(fā)璃诀,最常見的是生成.java 源文件蔑匣,并在程序中可以調(diào)用到生成的文件裁良。這樣我們就可以用注解來幫助我們處理一些固定邏輯的重復(fù)性代碼(如butterknife),提高開發(fā)的效率牧抵。
通過注解處理器來生成 .java 源文件基本上都會使用javapoet 這個庫彼棍,JavaPoet一個是用于產(chǎn)生 .java 源文件的輔助庫座硕,它可以很方便地幫助我們生成需要的.java 源文件涕蜂,下面來看下具體使用方法。
JavaPoet
在使用前需要先引入這個庫蜘拉,和 AutoService一樣可以通過**AndroidStudio **直接添加有鹿,如下:
下面以最簡單的 HelloWorld 例子來看下怎么使用JavaPoet葱跋。
先定義一個注解:
/**
* JavaPoet HelloWorld 例子
*/
@Retention(RetentionPolicy.CLASS)
@Target(ElementType.TYPE)
public @interface JPHelloWorld {
}
在定義個注解處理器來處理這個注解:
/**
* 處理HelloWorld注解.
*/
@AutoService(Processor.class)
public class HelloWorldProcess extends AbstractProcessor {
private Filer filer;
@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
super.init(processingEnv);
// Filer是個接口娱俺,支持通過注解處理器創(chuàng)建新文件
filer = processingEnv.getFiler();
}
@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
for (TypeElement element : annotations) {
if (element.getQualifiedName().toString().equals(JPHelloWorld.class.getCanonicalName())) {
// 創(chuàng)建main方法
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();
// 創(chuàng)建HelloWorld類
TypeSpec helloWorld = TypeSpec.classBuilder("HelloWorld")
.addModifiers(Modifier.PUBLIC, Modifier.FINAL)
.addMethod(main)
.build();
try {
// 生成 com.example.HelloWorld.java
JavaFile javaFile = JavaFile.builder("com.example", helloWorld)
.addFileComment(" This codes are generated automatically. Do not modify!")
.build();
// 生成文件
javaFile.writeTo(filer);
} catch (IOException e) {
e.printStackTrace();
}
}
}
return true;
}
@Override
public Set<String> getSupportedAnnotationTypes() {
Set<String> annotations = new LinkedHashSet<>();
annotations.add(JPHelloWorld.class.getCanonicalName());
return annotations;
}
@Override
public SourceVersion getSupportedSourceVersion() {
return SourceVersion.latestSupported();
}
}
在用 JavaPoet 來生成一個HelloWorld.java文件之前模庐,我們還必須在 init()方法里獲取到 Filer掂碱,這是一個用來輔助創(chuàng)建文件的接口,我們生成文件都通過它來處理疼燥。在 process()方法先創(chuàng)建了個 MethodSpec 表示一個方法,再創(chuàng)建一個 TypeSpec 表示一個類并添加上前面創(chuàng)建的方法搏恤,最后用 JavaFile 來生成對應(yīng)的HelloWorld.java 并寫入文件湃交。
這是最簡單的例子搞莺,整個語法結(jié)構(gòu)也很清晰,相信做編程的看到這些使用方法都能猜到是做什么用的迈喉,我就沒詳細說了温圆。除了這個例子,Github上還有很多其它示例岁歉,如果你想很好地了解編譯時注解的使用的話锅移,還是很有必要把每個例子都過一遍,如果不想自己敲粘貼復(fù)制下很容易的非剃。
在代碼中使用定義的注解:
@JPHelloWorld
public class MainActivity extends AppCompatActivity{
// ...
}
重新 Make 下工程就可以看到生成的 **HelloWorld.java **文件了备绽,目錄如下:
可以看到已經(jīng)成功生成了 HelloWorld.java 文件疯坤,注意生成文件所在的目錄,現(xiàn)在我們就可以在項目中直接使用這個 java 類了眠冈。當然了蜗顽,這個例子沒有什么實際的使用價值,你可以參考其它例子來生成你想要的代碼雇盖,用法是很多的崔挖。
這里只寫了個最簡單的例子,沒有深入更詳細的使用方法薛匪,等后面有時間再來整理個更詳細的介紹脓鹃。