Android AOP三劍客之APT

AOP概念

AOP爲Aspect Oriented Programming的縮寫,意爲:面向切面編程,通過預編譯方式和運行期動態代理實現程序功能的統一維護的一種技術。AOP是OOP的延續,是軟件開發中的一個熱點,也是Spring框架中的一個重要內容,是函數式編程的一種衍生範型。利用AOP可以對業務邏輯的各個部分進行隔離,從而使得業務邏輯各部分之間的耦合度降低,提高程序的可重用性,同時提高了開發的效率。

Android AOP三劍客: APT, AspectJ, Javassist
這是一張用爛了的圖.jpg

傳送門:android-aop-samples

工程目錄結構

.

  • annotation 定義註解
  • apt-library apt輔助工具類
  • apt-processor 自定義註解解析器,生成輔助代碼
  • apt-plugin 自定義Gradle插件,實現切面和操作字節碼的插件
  • app 主目錄

Android APT

APT(Annotation Processing Tool 的簡稱),可以在代碼編譯期解析註解,並且生成新的 Java 文件,減少手動的代碼輸入。現在有很多主流庫都用上了 APT,比如 Dagger2, ButterKnife, EventBus3 等

定義註解
@Retention(RetentionPolicy.CLASS)
@Target(ElementType.FIELD)
public @interface BindView {
int value();
}
創建一個Module,自定義AbstractProcessor,並且用@AutoService標記
  • AutoService會自動在META-INF文件夾下生成Processor配置信息文件,該文件裏就是實現該服務接口的具體實現類。而當外部程序裝配這個模塊的時候,
    就能通過該jar包META-INF/services/裏的配置文件找到具體的實現類名,並裝載實例化,完成模塊的注入
@AutoService(Processor.class)
public class BindViewProcessor extends AbstractProcessor {

private Messager mMessager;
private Elements mElementUtils;
private Map<String, ClassFactory> mProxyMap = new HashMap<>();

@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
    super.init(processingEnv);
    mMessager = processingEnv.getMessager();
    mElementUtils = processingEnv.getElementUtils();
}

@Override
public Set<String> getSupportedAnnotationTypes() {
    HashSet<String> supportTypes = new LinkedHashSet<>();
    supportTypes.add(BindView.class.getCanonicalName());
    return supportTypes;
}

@Override
public SourceVersion getSupportedSourceVersion() {
    return SourceVersion.latestSupported();
}

@Override
public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
    mMessager.printMessage(Diagnostic.Kind.NOTE, "processing...");
    mProxyMap.clear();
    //得到所有的註解
    Set<? extends Element> elements = roundEnvironment.getElementsAnnotatedWith(BindView.class);
    for (Element element : elements) {
        VariableElement variableElement = (VariableElement) element;
        TypeElement classElement = (TypeElement) variableElement.getEnclosingElement();
        String fullClassName = classElement.getQualifiedName().toString();
        //elements的信息保存到mProxyMap中
        ClassFactory proxy = mProxyMap.get(fullClassName);
        if (proxy == null) {
            proxy = new ClassFactory(mElementUtils, classElement);
            mProxyMap.put(fullClassName, proxy);
        }
        BindView bindAnnotation = variableElement.getAnnotation(BindView.class);
        int id = bindAnnotation.value();
        proxy.putElement(id, variableElement);
    }

    //通過javapoet生成
    for (String key : mProxyMap.keySet()) {
        ClassFactory proxyInfo = mProxyMap.get(key);
        JavaFile javaFile = JavaFile.builder(proxyInfo.getPackageName(), proxyInfo.generateJavaCode()).build();
        try {
            // 生成文件
            javaFile.writeTo(processingEnv.getFiler());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    mMessager.printMessage(Diagnostic.Kind.NOTE, "process finish ...");
    return true;
}

}

process方法,處理我們自定義的註解,生成代碼,這裏使用的squareup公司的javapoet庫輔助生成代碼

public class ClassFactory {
private String mBindingClassName;
private String mPackageName;
private TypeElement mTypeElement;
private Map<Integer, VariableElement> mVariableElementMap = new HashMap<>();

public ClassFactory(Elements elementUtils, TypeElement classElement) {
    this.mTypeElement = classElement;
    PackageElement packageElement = elementUtils.getPackageOf(mTypeElement);
    String packageName = packageElement.getQualifiedName().toString();
    String className = mTypeElement.getSimpleName().toString();
    this.mPackageName = packageName;
    this.mBindingClassName = className + "_ViewBinding";
}

public void putElement(int id, VariableElement element) {
    mVariableElementMap.put(id, element);
}

public TypeSpec generateJavaCode() {
    TypeSpec bindingClass = TypeSpec.classBuilder(mBindingClassName)
            .addModifiers(Modifier.PUBLIC)
            .addMethod(generateMethods())
            .build();
    return bindingClass;

}

    private MethodSpec generateMethods() {
    ClassName activity = ClassName.bestGuess(mTypeElement.getQualifiedName().toString());
    MethodSpec.Builder methodBuilder = MethodSpec.methodBuilder("bind")
            .addModifiers(Modifier.PUBLIC)
            .returns(void.class)
            .addParameter(activity, "activity");

    for (int id : mVariableElementMap.keySet()) {
        VariableElement element = mVariableElementMap.get(id);
        String name = element.getSimpleName().toString();
        String type = element.asType().toString();

        methodBuilder.addCode("activity." + name + " = " + "(" + type + ")(((android.app.Activity)activity).findViewById( " + id + "));\n\n");
    }

    return methodBuilder.build();
}


public String getPackageName() {
    return mPackageName;
}
}

generateMethods方法通過for循環構建代碼,findViewById綁定view

我們先看下原本的MainActivity有什麼東東

public class MainActivity extends AppCompatActivity {

@BindView(R.id.button)
Button button;

@BindView(R.id.tv)
TextView textView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    BindViewTools.bind(this);
    textView.setText("bind Button success");
    button.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            doMarkDown();
        }
    });
}
}

這個BindViewTools.bind(this)傳送門進去看看

public class BindViewTools {
public static void bind(Activity activity) {
    Class clazz = activity.getClass();
    try {
        Class bindViewClass = Class.forName(clazz.getName() + "_ViewBinding");
        Method method = bindViewClass.getMethod("bind", activity.getClass());
        method.invoke(bindViewClass.newInstance(), activity);
    } catch (ClassNotFoundException e) {
        e.printStackTrace();
    } catch (IllegalAccessException e) {
        e.printStackTrace();
    } catch (InstantiationException e) {
        e.printStackTrace();
    } catch (NoSuchMethodException e) {
        e.printStackTrace();
    } catch (InvocationTargetException e) {
        e.printStackTrace();
    }
}

}
我們可以看到他是通過反射尋找的是MainActivity_ViewBinding的類,並進行Id綁定的

可以在build/intermediates/classes/debug/包名/MainActivity_ViewBinding.class看到生成的代碼

這下就很清晰了

1.首先定義註解
2.BindViewProcessor裏的process 解析註解,生成輔助類MainActivity_ViewBinding
3.在入口BindViewTools.bind(this),反射找到生成的MainActivity_ViewBinding類並進行findViewById。

總結

本章節主要說了APT的簡單使用,從使用角度來說,APT技術並沒有難度,重點是怎麼設計,在實際項目中可以把很多繁瑣重複性的工作,通過APT來生成各種代碼.

作爲老司機,這是彎道超車的必備祕籍,天下武功、唯快不破!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章