簡介
APT,就是Annotation Processing Tool 的簡稱,簡單來說就是通過編碼來動態得到解析Annotation的工具。一般分為兩類:
1.執行時註解:比如大名鼎鼎的retrofit就是用執行時註解,通過動態代理來生成網路請求
2.編譯時註解:比如Dagger2, ButterKnife, EventBus3
程式碼實現
這裡我們要實現一個怎樣的功能呢?第一個就是給我們的activity新增一個@Flag,然後當我們編譯的時候就會生成一個java main函式。第二個就是我簡易版的butterknife。2個註解都是寫在用一個外掛中。好了下面直接開始。
Annotation module
首先我們建立一個my_annotation的java module,這個專案只放我們的註解檔案,不涉及到註解處理等其他邏輯,關於註解處理我們會新建一個module來處理。專案結構如下:
其中build.gradle中基本不用修改,保持預設的配置就可以,如下:
Flag註解
就是這麼簡單,關於註解中元註解的解釋請參考我的另一篇文章:元註解簡介
關於註解module就到這了。
註解處理 module
首先我們建立一個my_compiler的java module。專案結構如下:
build.gradle的配置如下:
簡單解釋下幾個dependencies
auto-service:這是google推出的方便我們編寫annotation外掛,在沒有這個這個庫之前,我們需要對我們的外掛做很多的配置才能使用,有了這個庫以後就方便多了,下文會看到怎麼用,這裡就不介紹了。
javapoet:這是方便我們在編譯時動態生成class檔案的,下文也會有具體怎麼使用,這裡不做過多解釋。
關於上面2個庫大家感興趣可以去查詢相關資料進行進一步瞭解。下面我們看下真正的註解處理類:
/**
* @author Jin
*/
//來自auto-service 只要新增這個註解以後就不需要做其他配置,現在已經可以在專案中直接使用了
@AutoService(Processor.class)
public class FlagAnnotationProcessor extends AbstractProcessor {
/**
* getSupportedSourceVersion()方法返回 Java 版本 預設為Java6
*
* @return Java 版本
*/
@Override
public SourceVersion getSupportedSourceVersion() {
return SourceVersion.latestSupported();
}
/**
* 返回要處理的註解的結合 這裡只處理RouterAnnotion型別的註解
*
* @return
*/
@Override
public Set<String> getSupportedAnnotationTypes() {
LinkedHashSet<String> types = new LinkedHashSet<>();
types.add(Flag.class.getCanonicalName());
return types;
}
/**
* 註解的具體處理類
*
* @param annotations
* @param roundEnv
* @return
*/
@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
//來自javapoet 動態生成方法
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();
//來自javapoet 動態生成類
TypeSpec helloWorld = TypeSpec.classBuilder("HelloWorld")
.addModifiers(Modifier.PUBLIC, Modifier.FINAL)
.addMethod(main)
.build();
//來自javapoet 動態生成檔案
JavaFile javaFile = JavaFile.builder("com.jin.helloworld", helloWorld)
.build();
try {
javaFile.writeTo(processingEnv.getFiler());
} catch (IOException e) {
e.printStackTrace();
}
return true;
}
}複製程式碼
註解處理類已經寫好了,下面我們看下怎麼關聯到我們的專案中。
註解使用
AndroidStudio3.0使用annotationProcessor來處理註解。
新增我們的@Flag註解。ok。大功告成,下面重新編譯(rebuild project)一下我們的專案,就會在build目錄下看到自動生成的程式碼了。
你可能會說,生成一個HelloWorld main函式並木有什麼卵用啊,是的,但是你起碼掌握了最基本的關於Annotation專案的建立、編譯、使用了是不是,麻雀雖小但是五臟俱全啊。
下面進入我們的另一個demo,簡易版butterknife。
簡易版butterknife
下面我直接添上註解和處理程式碼(相關解釋會在註釋中):
DIAnnotationProcessor
@AutoService(Processor.class)
public class DIAnnotationProcessor extends AbstractProcessor {
private Filer mFiler;
private Elements elementUtils;
/**
* init()方法可以初始化拿到一些使用的工具,
* 比如檔案相關的輔助類 Filer;元素相關的輔助類Elements;日誌相關的輔助類Messager;
*
* @param processingEnv
*/
@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
super.init(processingEnv);
mFiler = processingEnv.getFiler();
elementUtils = processingEnv.getElementUtils();
}
/**
* getSupportedSourceVersion()方法返回 Java 版本 預設為Java6
*
* @return Java 版本
*/
@Override
public SourceVersion getSupportedSourceVersion() {
return SourceVersion.latestSupported();
}
/**
* 返回要處理的註解的結合 這裡只處理RouterAnnotion型別的註解
*
* @return
*/
@Override
public Set<String> getSupportedAnnotationTypes() {
LinkedHashSet<String> types = new LinkedHashSet<>();
types.add(BindActivity.class.getCanonicalName());
return types;
}
/**
* 註解的具體處理類
*
* @param annotations
* @param roundEnv
* @return
*/
@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
System.out.println("DIAnnotationProcessor");
//得到所有被Bind新增註解的類
Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(BindActivity.class);
for (Element element : elements) {
//強制轉換成TypeElement 判斷是否是Class
TypeElement typeElement = (TypeElement) element;
//得到typeElement類中所有成員變數和成員方法
List<? extends Element> members = elementUtils.getAllMembers(typeElement);
MethodSpec.Builder bindViewMethodSpecBuilder = MethodSpec.methodBuilder("bindView")
.addModifiers(Modifier.PUBLIC, Modifier.STATIC)
.returns(TypeName.VOID)
.addParameter(ClassName.get(typeElement.asType()), "activity");
for (Element item : members) {
BindMyView bindView = item.getAnnotation(BindMyView.class);
if (bindView == null) {
continue;
}
bindViewMethodSpecBuilder.addStatement(String.format("activity.%s = (%s) activity.findViewById(%s)", item.getSimpleName(), ClassName.get(item.asType()).toString(), bindView.value()));
}
TypeSpec typeSpec = TypeSpec.classBuilder("DI" + element.getSimpleName())
.superclass(TypeName.get(typeElement.asType()))
.addModifiers(Modifier.PUBLIC, Modifier.FINAL)
.addMethod(bindViewMethodSpecBuilder.build())
.build();
JavaFile javaFile = JavaFile.builder(getPackageName(typeElement), typeSpec).build();
try {
javaFile.writeTo(processingEnv.getFiler());
} catch (IOException e) {
e.printStackTrace();
}
}
return true;
}
private String getPackageName(TypeElement type) {
return elementUtils.getPackageOf(type).getQualifiedName().toString();
}
}複製程式碼
DI Annotation使用
注意此時一定要先rebuild project生成如下檔案
然後在我們的程式碼中寫上
這裡ButterKnife.bind(this)是用來對比,請大家注意, DIMainActivity.bindView(this)才是我們直接生成的檔案。
#除錯(AndroidStudio3.0)已解決
如果過你也像我一樣按照網上的教程操作,但是始終報錯:Unable to open debugger port (localhost:5006): java.net.ConnectException "Connection refused: connect"
配置如下:
上面的配置程式碼記得在全域性的gradle.properties中新增 該檔案一般位於C:\Users\Jin.gradle下 如果沒有親手動建立