Android 组件化路由组件 ( 注解处理器中使用 JavaPoet 生成代码 )

Posted 韩曙亮

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android 组件化路由组件 ( 注解处理器中使用 JavaPoet 生成代码 )相关的知识,希望对你有一定的参考价值。

在这里插入图片描述

组件化系列博客 :


【Android 组件化】路由组件 ( 注解处理器获取被注解的节点 ) 博客中 声明了 支持的注解类型 , 并在 Activity 中使用了注解 , 在 注解处理器 中检测出来使用注解的 类节点 TypeElement ;

本篇博客中讲解 " 注解处理器 " 后续开发 , 生成 Java 代码 ;





一、注解节点类型



在 " 注解处理器 " AbstractProcessor 中的 process 方法中 , 可以获取使用注解的节点 ;


使用注解标注的 Element 节点类型 : 注解节点都是 javax.lang.model.element.Element 的子类

  • ExecutableElement : 使用注解的 方法 节点类型 ;

  • VariableElement : 使用注解的 字段 节点类型 , 类的成员变量 ;

  • TypeElement : 使用注解的 类 节点类型 ;

  • PackageElement : 使用注解的 包 节点类型 ;


在类上使用 @Route 注解 , 则获取的节点类型都是 TypeElement ;





二、JavaPoet 简介



JavaPoet 的作用是用于生成 Java 源代码 ;


JavaPoet 项目 GitHub 地址 : https://github.com/square/javapoet


添加依赖库 :android Studio 项目中的 Module 下的 build.gradle 添加如下依赖库 , 即可使用 JavaPoet ;

compile 'com.squareup:javapoet:1.13.0'

使用 JavaPoet 生成方法 : 调用 MethodSpec 的如下方法可以完成 Java 函数创建 ;

  • methodBuilder 静态方法 , 创建方法 , 参数是函数名 ,
  • addModifiers 方法可以设置函数的可见性 , 是否是静态方法 ,
  • returns 方法设置返回值 ,
  • addParameter 方法设置函数参数类型 , 以及参数名称 ,
  • addStatement 方法设置函数体 ,
  • build 方法正式生成函数 ;
// 生成 public static void main(String[] args) 函数
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();

生成的 Java 函数如下 :

  public static void main(String[] args) {
    System.out.println("Hello, JavaPoet!");
  }

使用 JavaPoet 生成方法 : 调用 TypeSpec 的如下方法可以完成 Java 类创建 ;

  • classBuilder 静态方法 , 创建类 , 参数是类名 ,
  • addModifiers 方法可以设置类的可见性 , 是否是 final 方法 ,
  • addMethod 方法设置类中的函数 ;
// 指定 public final class HelloWorld 类 
TypeSpec helloWorld = TypeSpec.classBuilder("HelloWorld")
    .addModifiers(Modifier.PUBLIC, Modifier.FINAL)
    .addMethod(main)
    .build();

生成的 HelloWoirld 类如下 :

public final class HelloWorld {
  public static void main(String[] args) {
    System.out.println("Hello, JavaPoet!");
  }
}




三、注解处理器中使用 JavaPoet 生成代码



【Android APT】注解处理器 ( 根据注解生成 Java 代码 ) 博客中使用 字符输出流 Writer 直接写出字符串的方式 , 生成了 Java 代码 , 不过每行代码都需要自己生成 ,


注解处理器 中 , 使用 Filer 对象写出 Java 代码 , 获取 Filer 对象 , 保存在成员字段 Filer mFiler 中 ;

AbstractProcessor 注解处理器的 init 方法中 , 调用 ProcessingEnvironment processingEnvironment 参数的 getFiler 方法 , 获取 Filer 对象 ;

在 AbstractProcessor 注解处理器的 process 中根据获取的注解 , 生成相关代码 ;


注解处理器 使用 JavaPoet 示例 :

package kim.hsl.router_compiler;

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.Set;

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.SupportedSourceVersion;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.Modifier;
import javax.lang.model.element.TypeElement;
import javax.tools.Diagnostic;

// 自动注册注解处理器
@AutoService(Processor.class)
// 支持的注解类型
@SupportedAnnotationTypes({"kim.hsl.router_annotation.Route"})
// 支持的 Java 版本
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class RouterProcessor extends AbstractProcessor {

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

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

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

        this.mFiler = processingEnvironment.getFiler();
    }

    /**
     * 该函数在注解处理器注册时自动执行, 是处理注解的核心函数
     *
     * Set<? extends TypeElement> set 参数 : 该集合表示使用了相关注解的节点的集合
     *
     * @param set
     * @param roundEnvironment
     * @return
     */
    @Override
    public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
        for (TypeElement typeElement: set){
            mMessager.printMessage(Diagnostic.Kind.NOTE, "SupportedAnnotationTypes : " + typeElement.getQualifiedName());
        }

        // 生成 public static void main(String[] args) 函数
        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();

        // 指定 public final class HelloWorld 类
        TypeSpec helloWorld = TypeSpec.classBuilder("HelloWorld")
                .addModifiers(Modifier.PUBLIC, Modifier.FINAL)
                .addMethod(main)
                .build();

        // 正式在 "com.example.helloworld" 包名下创建 HelloWorld 类
        JavaFile javaFile = JavaFile.builder("com.example.helloworld", helloWorld)
                .build();

        try {
            javaFile.writeTo(mFiler);
        } catch (IOException e) {
            e.printStackTrace();
        }

        return false;
    }
}

生成代码如下 :

package com.example.helloworld;

import java.lang.String;
import java.lang.System;

public final class HelloWorld {
  public static void main(String[] args) {
    System.out.println("Hello, JavaPoet!");
  }
}

代码生成在 " app\\build\\generated\\ap_generated_sources\\debug\\out\\com\\example\\helloworld " 路径下 ;

在这里插入图片描述

利用 编译时技术 APT 生成的 HelloWorld 类在 Android 应用中是可以被调用的 ;





四、路由框架说明



路由框架 主要是利用 编译时技术 APT , 依据开发者在开发时 标注的 编译时注解 , 在编译的时候 生成一系列 Java 代码 , 然后在运行时 , 可以调用这些 Java 代码 ;

生成的 Java 代码就是 路由表数据 , 路由表中有若干路由选项 , 每个路由选项都由 路由地址 和 路由信息 组成 ,

  • 路由地址 : 字符串地址 ;
  • 路由信息 : Class 对象 , Activity 或 Service 的字节码类对象 ;

从路由表中 , 根据路由地址 , 获取相应的路由对象 , 可以直接跳转到对应 Activity 界面 , 或调用 相应的 Service 服务 ;


下一篇博客开始开发上述路由表逻辑 ;





五、博客资源



博客源码 :



在这里插入图片描述

以上是关于Android 组件化路由组件 ( 注解处理器中使用 JavaPoet 生成代码 )的主要内容,如果未能解决你的问题,请参考以下文章

Android 组件化路由组件 ( 构造路由表中的路由信息 )

Android 组件化路由组件 ( 注解处理器参数选项设置 )

Android 组件化路由组件 ( 注解处理器参数选项设置 )

Android 组件化路由组件 ( 注解处理器中使用 JavaPoet 生成代码 )

Android 组件化路由组件 ( 运行时获取 注解处理器 生成的路由表 )

Android 组件化路由组件 ( 运行时获取 注解处理器 生成的路由表 )