Android 组件化路由组件 ( 页面跳转参数依赖注入 )

Posted 2021-05-26 韩曙亮

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android 组件化路由组件 ( 页面跳转参数依赖注入 )相关的知识，希望对你有一定的参考价值。

文章目录

一、参数自动注入
二、自定义注解
三、使用 @Extra 自定义注解
四、注解处理器解析 @Extra 自定义注解并生成相应 Activity 对应代码
五、博客资源

在这里插入图片描述

组件化系列博客 :

一、参数自动注入

在组件化中 , 使用路由组件进行界面跳转时 , 涉及到参数的传递 , 传递过去的参数需要在目的地 Activity 的 onCreate 方法中 , 调用 getIntent().getXxxExtra() 获取到传递的值 ;

如果一次性传递十几个 , 乃至几十个参数 , 这样就需要写很多次 getIntent().getXxxExtra() 样式的代码 , 这里引入注入框架 , 类似于 ButterKnife , 只要在目的 Activity 中的成员属性上标注注解 , 可以自动生成 getIntent().getXxxExtra() 相关逻辑 , 开发者不必手动编写此类逻辑 ;

ButterKnife 的作用是在 Activity 的成员属性上标注 @BindView 注解 , 自动生成 findViewById 代码 ;

二、自定义注解

自定义 Extra 注解 ,

@Target({ElementType.FIELD}) 元注解表示该注解用于标注成员字段 ,

@Retention(RetentionPolicy.CLASS) 元注解表示该注解保留到字节码编译时 ,

注解中定义了一个注解属性 name , 默认值为 “” ;

自定义注解代码示例 :

package kim.hsl.router_annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 参数自动注入注解
 * 该注解使用在 成员字段 上面
 */
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.CLASS)
public @interface Extra {
    /**
     * 参数名称
     * @return
     */
    String name() default "";
}

三、使用 @Extra 自定义注解

在 Activity 中 , 使用 @Route 和 @Extra 自定义注解 ;

package kim.hsl.library3;

import android.os.Bundle;

import com.google.android.material.floatingactionbutton.FloatingActionButton;
import com.google.android.material.snackbar.Snackbar;

import androidx.appcompat.app.AppCompatActivity;
import androidx.appcompat.widget.Toolbar;

import android.view.View;

import kim.hsl.router_annotation.Extra;
import kim.hsl.router_annotation.Route;

@Route(path = "/library3/MainActivity")
public class MainActivity extends AppCompatActivity {

    /**
     * 姓名
     */
    @Extra
    private String name;

    /**
     * 年龄
     */
    @Extra
    private int age;

    /**
     * 身高
     */
    @Extra
    private int height;

    /**
     * 体重
     */
    @Extra
    private int weight;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = findViewById(R.id.toolbar);
    }
}

四、注解处理器解析 @Extra 自定义注解并生成相应 Activity 对应代码

注解处理器中解析上述注解 , 生成如下代码 , 生成代码位置 " D:\\002_Project\\002_Android_Learn\\Component\\library3\\build\\generated\\ap_generated_sources\\debug\\out\\kim\\hsl\\library3\\MainActivity_Extra.java "

package kim.hsl.library3;

import java.lang.Object;
import java.lang.Override;
import kim.hsl.route_core.template.IExtra;

public class MainActivity_Extra implements IExtra {
  @Override
  public void loadExtra(Object target) {
    MainActivity t = (MainActivity)target;
    t.name = t.getIntent().getStringExtra("name");
    t.age = t.getIntent().getIntExtra("age", t.age);
    t.height = t.getIntent().getIntExtra("height", t.height);
    t.weight = t.getIntent().getIntExtra("weight", t.weight);
  }
}

生成上述代码的注解处理器 :

package kim.hsl.router_compiler;

import com.google.auto.service.AutoService;
import com.squareup.javapoet.ArrayTypeName;
import com.squareup.javapoet.ClassName;
import com.squareup.javapoet.JavaFile;
import com.squareup.javapoet.MethodSpec;
import com.squareup.javapoet.ParameterSpec;
import com.squareup.javapoet.ParameterizedTypeName;
import com.squareup.javapoet.TypeName;
import com.squareup.javapoet.TypeSpec;
import com.squareup.javapoet.WildcardTypeName;

import java.io.IOException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.TreeMap;

import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.Filer;
import javax.annotation.processing.Messager;
import javax.annotation.processing.ProcessingEnvironment;
import javax.annotation.processing.Processor;
import javax.annotation.processing.RoundEnvironment;
import javax.annotation.processing.SupportedAnnotationTypes;
import javax.annotation.processing.SupportedOptions;
import javax.annotation.processing.SupportedSourceVersion;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.Element;
import javax.lang.model.element.Modifier;
import javax.lang.model.element.TypeElement;
import javax.lang.model.type.TypeKind;
import javax.lang.model.type.TypeMirror;
import javax.lang.model.util.Elements;
import javax.lang.model.util.Types;
import javax.tools.Diagnostic;

import kim.hsl.router_annotation.Extra;
import kim.hsl.router_annotation.Route;
import kim.hsl.router_annotation.model.RouteBean;

import static javax.lang.model.element.Modifier.PUBLIC;

// 注解处理器接收的参数
@SupportedOptions("moduleName")
// 自动注册注解处理器
@AutoService(Processor.class)
// 支持的注解类型
@SupportedAnnotationTypes({"kim.hsl.router_annotation.Extra"})
// 支持的 Java 版本
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class ExtraProcessor extends AbstractProcessor {

    /**
     * 注解处理器中使用 Messager 对象打印日志
     */
    private Messager mMessager;

    /**
     * 用于写出生成的 Java 代码
     */
    private Filer mFiler;

    /**
     * 注解节点工具
     */
    private Elements mElementUtils;
    /**
     * 类工具
     */
    private Types mTypeUtils;

    /**
     * 获取的 moduleName 参数
     */
    private String mModuleName;

    /**
     * 获取所有需要注入的节点集合 , 并按照其父节点 Activity 进行分组
     * 键 ( Key ) : Activity 节点
     * 值 ( Value ) : Activity 中被 @Extra 注解的属性节点
     */
    private Map<TypeElement, List<Element>> mActivity2Field = new HashMap<>();


    /**
     * 该函数在初始化时调用 , 相当于构造函数
     * @param processingEnvironment
     */
    @Override
    public synchronized void init(ProcessingEnvironment processingEnvironment) {
        super.init(processingEnvironment);
        // 获取打印日志接口
        this.mMessager = processingEnvironment.getMessager();
        // 测试日志打印
        mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : Messager Print Log");

        this.mFiler = processingEnvironment.getFiler();
        this.mElementUtils = processingEnvironment.getElementUtils();
        this.mTypeUtils = processingEnvironment.getTypeUtils();

        // 获取 moduleName 参数
        // 先获取 注解处理器 选项
        Map<String, String> options = processingEnvironment.getOptions();
        if (options != null){
            mModuleName = options.get("moduleName");
            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : 打印 moduleName 参数 : " + mModuleName);
        }
    }

    /**
     * 该函数在注解处理器注册时自动执行, 是处理注解的核心函数
     *
     * Set<? extends TypeElement> set 参数 : 该集合表示使用了相关注解的节点的集合
     *
     * @param set
     * @param roundEnvironment
     * @return
     */
    @Override
    public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
        mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : " + mModuleName + " process ");
        if (set == null || set.isEmpty()){
            // 如果没有检测到注解 , 直接退出
            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : 检测到注解为空 , 直接退出 mModuleName : " + mModuleName);
            return false;
        }

        // 获取被 @Extra 注解的属性节点集合
        Set<? extends Element> elements = roundEnvironment.getElementsAnnotatedWith(Extra.class);

        // 采集这些属性节点集合的 类型 和 变量名称
        for (Element element : elements) {
            // 获取这些被 @Extra 标注的字段的父节点 Activity 节点
            TypeElement activityElement = (TypeElement) element.getEnclosingElement();
            if (mActivity2Field.containsKey(activityElement)) {
                // 如果该 Activity 父节点存在 , 直接添加到子节点集合中
                mActivity2Field.get(activityElement).add(element);
            } else {
                // 如果该 Activity 父节点不存在 , 先创建子节点集合 , 再添加到集合中
                List<Element> childs = new ArrayList<>();
                childs.add(element);
                mActivity2Field.put(activityElement, childs);
            }
            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : " + mModuleName + " 添加注解类型 : " + element.getSimpleName());
        }

        // 至此 , 已经将所有 Activity 以及其下使用 @Extra 标注的属性都存放在了
        // Map<TypeElement, List<Element>> mActivity2Field 集合中


        /*
            生成 Java 代码
         */

        // 获取 Activity 类型
        TypeMirror activityTypeMirror = mElementUtils.getTypeElement("android.app.Activity").asType();
        // 获取 IExtra 接口类型节点
        TypeElement IExtra = mElementUtils.getTypeElement("kim.hsl.route_core.template.IExtra");

        // 生成 IExtra 接口中 void loadExtra(Object target); 方法的 Object target 参数
        ParameterSpec objectParamSpec = ParameterSpec.builder(TypeName.OBJECT, "target").build();

        // 遍历所有需要注入的 类:属性
        for (Map.Entry<TypeElement, List<Element>> entry : mActivity2Field.entrySet()) {
            // 每个 Map 键值对元素都要生成一个对应的 Java 类

            // 获取 Activity 类
            TypeElement rawClassElement = entry.getKey();
            // 如果该类不是 Activity 子类 , 直接抛出异常
            if (!mTypeUtils.isSubtype(rawClassElement.asType(), activityTypeMirror)) {
                throw new RuntimeException("ExtraProcessor Activity 类型错误");
            }

            // 创建 void loadExtra(Object target) 方法
            MethodSpec.Builder builder = MethodSpec.methodBuilder("loadExtra")
                    .addAnnotation(Override.class)
                    .addModifiers(Modifier.PUBLIC)
                    .addParameter(objectParamSpec);

            // 生成类型转换代码 : MainActivity t = (MainActivity)target;
            // 获取 Activity 类名称
            ClassName className = ClassName.get(rawClassElement);
            // 类型转换, 将 Activity 类转为指定的 Activity 子类类型
            builder.addStatement("$T t = ($T)target", className, className);

            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : 开始循环 Map 元素个数" + entry.getValue().size());

            // 遍历被 @Extra 标注的属性字段
            for (int i = 0; i < entry.getValue().size(); i++) {
                Element element = entry.getValue().get(i);
                buildStatement(element, builder);
            }

            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : 结束循环 Map 元素个数" + entry.getValue().size());


            // 生成 java 类名, 原来的 Activity 类名基础上添加 "_Extra" 后缀
            String extraClassName = rawClassElement.getSimpleName() + "_Extra";

            // 创建 Java 类
            TypeSpec typeSpec = TypeSpec.classBuilder(extraClassName)
                    .addSuperinterface(ClassName.get(IExtra))   // 实现 IExtra 接口
                    .addModifiers(PUBLIC)   //
                    .addMethod(builder.build()) // 设置函数
                    .build();   // 正式创建

            // Java 文件
            JavaFile javaFile = JavaFile.builder(className.packageName(), typeSpec).build();

            // 写出生成的 java 代码
            try {
                javaFile.writeTo(mFiler);
            } catch (IOException e) {
                e.printStackTrace();
            }


            mMessager.printMessage(Diagnostic.Kind.NOTE, "ExtraProcessor : 生成文件结束 : " + mModuleName + " " +javaFile.toString());
        }
        return true;
    }

    /**
     * 拼装如下代码
     * t.a = t.getIntent().getStringExtra("a");
     * @param element
     */
    public void buildStatement(Element element, MethodSpec.Builder builder) {
        TypeMirror typeMirror = element.asType();
        int type = typeMirror.getKind().ordinal();

        //属性名 String text 获得text
        String fieldName = element.getSimpleNameReact路由组件跳转页面并存储参数
 Vue 路由跳转传递参数，子组件页面刷新后数据不丢失
 react多个路由共用同一个组件模块，切换路由跳转页面不刷新问题
 Android组件化路由实践
 vue 路由跳转后 怎样去掉指定的组件
 vue传参的三种方式