页面路由框架，无论在android还是在iOS的开发中都是很常见的模块与模块之间的解耦工具，特别是对中大型App而言，基本上都会有自己的路由框架。
Processor的原理
在讲原理之前，先看看整个项目的结构。
- saf-router：是整个路由框架的核心，可以单独使用。
- saf-router-annotation：是路由框架的注解模块，可以基于注解来声明router跳转的页面。
- saf-router-compiler：由于我们的注解是编译时注解，而非运行时注解。在程序编译时会生成一个RouterManager的类，此类会管理App的router mapping信息。
然后，我们来看看神奇的RouterProcessor
package com.safframework.router import com.squareup.javapoet.ClassName import com.squareup.javapoet.JavaFile import com.squareup.javapoet.MethodSpec import com.squareup.javapoet.TypeSpec import java.util.* import javax.annotation.processing.* 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.util.Elements /** * Created by Tony Shen on 2017/1/10. */ //@AutoService(Processor::class) class RouterProcessor: AbstractProcessor() { var mFiler: Filer?=null //文件相关的辅助类 var mElementUtils: Elements?=null //元素相关的辅助类 var mMessager: Messager?=null //日志相关的辅助类 @Synchronized override fun init(processingEnv: ProcessingEnvironment) { super.init(processingEnv) mFiler = processingEnv.filer mElementUtils = processingEnv.elementUtils mMessager = processingEnv.messager } /** * @return 指定使用的 Java 版本。通常返回 SourceVersion.latestSupported()。 */ override fun getSupportedSourceVersion(): SourceVersion { return SourceVersion.latestSupported() } /** * @return 指定哪些注解应该被注解处理器注册 */ override fun getSupportedAnnotationTypes(): Set<String> { val types = LinkedHashSet<String>() types.add(RouterRule::class.java.canonicalName) return types } override fun process(annotations: Set<TypeElement>, roundEnv: RoundEnvironment): Boolean { val elements = roundEnv.getElementsAnnotatedWith(RouterRule::class.java) try { val type = getRouterTableInitializer(elements) if (type != null) { JavaFile.builder("com.safframework.router", type).build().writeTo(mFiler) } } catch (e: FilerException) { e.printStackTrace() } catch (e: Exception) { Utils.error(mMessager, e.message) } return true } @Throws(ClassNotFoundException::class) private fun getRouterTableInitializer(elements: Set<Element>?): TypeSpec? { if (elements == null || elements.size == 0) { return null } val routerInitBuilder = MethodSpec.methodBuilder("init") .addModifiers(Modifier.PUBLIC, Modifier.STATIC) .addParameter(TypeUtils.CONTEXT, "context") routerInitBuilder.addStatement("\$T.getInstance().setContext(context)", TypeUtils.ROUTER) routerInitBuilder.addStatement("\$T options = null", TypeUtils.ROUTER_OPTIONS) elements.map { it as TypeElement }.filter(fun(it: TypeElement): Boolean { return Utils.isValidClass(mMessager, it, "@RouterRule") }).forEach { val routerRule = it.getAnnotation(RouterRule::class.java) val routerUrls = routerRule.url val enterAnim = routerRule.enterAnim val exitAnim = routerRule.exitAnim if (routerUrls != null) { for (routerUrl in routerUrls!!) { if (enterAnim > 0 && exitAnim > 0) { routerInitBuilder.addStatement("options = new \$T()", TypeUtils.ROUTER_OPTIONS) routerInitBuilder.addStatement("options.enterAnim = " + enterAnim) routerInitBuilder.addStatement("options.exitAnim = " + exitAnim) routerInitBuilder.addStatement("\$T.getInstance().map(\$S, \$T.class,options)", TypeUtils.ROUTER, routerUrl, ClassName.get(it)) } else { routerInitBuilder.addStatement("\$T.getInstance().map(\$S, \$T.class)", TypeUtils.ROUTER, routerUrl, ClassName.get(it)) } } } } val routerInitMethod = routerInitBuilder.build() return TypeSpec.classBuilder("RouterManager") .addModifiers(Modifier.PUBLIC) .addMethod(routerInitMethod) .build() } }
kotlin用起来是很爽，但是还是踩过很多的坑。
- 坑1：
原先用java来写时，用谷歌的Auto库很顺畅地生成RouterManager类。换了kotlin以后，好像不行了，于是我用了土方法。创建了META-INF/services/javax.annotation.processing.Processor，并加上
com.safframework.router.RouterProcessor
这样才能生成RouterManager。
- 坑2：
原先getRouterTableInitializer()是长这样的：
private TypeSpec getRouterTableInitializer(Set<? extends Element> elements) throws ClassNotFoundException { if(elements == null || elements.size() == 0){ return null; } MethodSpec.Builder routerInitBuilder = MethodSpec.methodBuilder("init") .addModifiers(Modifier.PUBLIC,Modifier.STATIC) .addParameter(TypeUtils.CONTEXT,"context"); routerInitBuilder.addStatement("$T.getInstance().setContext(context)",TypeUtils.ROUTER); routerInitBuilder.addStatement("$T options = null",TypeUtils.ROUTER_OPTIONS); for(Element element : elements){ TypeElement classElement = (TypeElement) element; // 检测是否是支持的注解类型，如果不是里面会报错 if (!Utils.isValidClass(mMessager,classElement,"@RouterRule")) { continue; } RouterRule routerRule = element.getAnnotation(RouterRule.class); String [] routerUrls = routerRule.url(); int enterAnim = routerRule.enterAnim(); int exitAnim = routerRule.exitAnim(); if(routerUrls != null){ for(String routerUrl : routerUrls){ if (enterAnim>0 && exitAnim>0) { routerInitBuilder.addStatement("options = new $T()",TypeUtils.ROUTER_OPTIONS); routerInitBuilder.addStatement("options.enterAnim = "+enterAnim); routerInitBuilder.addStatement("options.exitAnim = "+exitAnim); routerInitBuilder.addStatement("$T.getInstance().map($S, $T.class,options)",TypeUtils.ROUTER, routerUrl, ClassName.get((TypeElement) element)); } else { routerInitBuilder.addStatement("$T.getInstance().map($S, $T.class)",TypeUtils.ROUTER, routerUrl, ClassName.get((TypeElement) element)); } } } } MethodSpec routerInitMethod = routerInitBuilder.build(); return TypeSpec.classBuilder("RouterManager") .addModifiers(Modifier.PUBLIC) .addMethod(routerInitMethod) .build(); }
我用kotlin对for循环进行了优化，起初还可以用map、filter，但是遇到两层for循环好像找不到更好的办法。本想用高阶函数，但是不想折腾了。如果您有更好的办法，一定要告诉我。
- 坑3：
Kotlin的类没有静态变量。不过有同伴对象(Companion Object)的概念。如果在某个类中声明一个同伴对象, 那么只需要使用类名作为限定符就可以调用同伴对象的成员了, 语法与Java中调用类的静态方法、静态变量一样。
举个栗子：
class TypeUtils { companion object { val CONTEXT = ClassName.get("android.content", "Context"); val ROUTER = ClassName.get("com.safframework.router", "Router") val ROUTER_OPTIONS = ClassName.get("com.safframework.router.RouterParameter", "RouterOptions") } }
既然踩了很多坑，那还是放上github地址吧：
https://github.com/fengzhizi715/SAF-Kotlin-Router
下载安装
在根目录下的build.gradle中添加
buildscript { repositories { jcenter() } dependencies { classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' } }
在app 模块目录下的build.gradle中添加
apply plugin: 'com.neenbedankt.android-apt' ... dependencies { compile 'com.safframework.router:saf-router:1.0.0' apt 'com.safframework.router:saf-router-compiler:1.0.0' ... }
特性
它提供了类似于rails的router功能，可以轻易地实现app的应用内跳转,包括Activity之间、Fragment之间实现相互跳转，并传递参数。
这个框架的saf-router-compiler模块是用kotlin编写的。
使用方法
Activity跳转
它支持Annotation方式和非Annotation的方式来进行Activity页面跳转。使用Activity跳转时，必须在App的Application中做好router的映射。
我们会做这样的映射，表示从某个Activity跳转到另一个Activity需要传递user、password这2个参数
Router.getInstance().setContext(getApplicationContext()); // 这一步是必须的，用于初始化Router Router.getInstance().map("user/:user/password/:password", DetailActivity.class);
有时候，activity跳转还会有动画效果，那么我们可以这么做
RouterOptions options = new RouterOptions(); options.enterAnim = R.anim.slide_right_in; options.exitAnim = R.anim.slide_left_out; Router.getInstance().map("user/:user/password/:password", DetailActivity.class, options);
Annotation方式
在任意要跳转的目标Activity上，添加@RouterRule,它是编译时的注解。
@RouterRule(url={"second/:second"}) public class SecondActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); Intent i = getIntent(); if (i!=null) { String second = i.getStringExtra("second"); Log.i("SecondActivity","second="+second); } } }
而且，使用@RouterRule也支持跳转的动画效果。
如果要跳转到SecondActivity，在App的任意地方只需：
Router.getInstance().open("second/1234"); // 1234表示传递的参数，是String类型。
用Annotation方式来进行页面跳转时，Application无需做router的映射。因为，saf-router-compiler模块已经在编译时生成了一个类RouterManager。它长得形如：
package com.safframework.router; import android.content.Context; import com.safframework.activity.SecondActivity; import com.safframework.router.RouterParameter.RouterOptions; public class RouterManager { public static void init(Context context) { Router.getInstance().setContext(context); RouterOptions options = null; Router.getInstance().map("second/:second", SecondActivity.class); } }
Application只需做如下调用，就可在任何地方使用Router了。
RouterManager.init(this);// 这一步是必须的，用于初始化Router
非Annotation方式
在Application中定义好router映射之后，activity之间跳转只需在activity中写下如下的代码，即可跳转到相应的Activity，并传递参数
Router.getInstance().open("user/fengzhizi715/password/715");
如果在跳转前需要先做判断，看看是否满足跳转的条件,doCheck()返回false表示不跳转，true表示进行跳转到下一个activity
Router.getInstance().open("user/fengzhizi715/password/715",new RouterChecker(){ public boolean doCheck() { return true; } );
Fragment跳转
Fragment之间的跳转也无须在Application中定义跳转映射。直接在某个Fragment写下如下的代码
Router.getInstance().openFragment(new FragmentOptions(getFragmentManager(),new Fragment2()), R.id.content_frame);
当然在Fragment之间跳转可以传递参数
Router.getInstance().openFragment("user/fengzhizi715/password/715",new FragmentOptions(getFragmentManager(),new Fragment2()), R.id.content_frame);
其他跳转
单独跳转到某个网页，调用系统电话，调用手机上的地图app打开地图等无须在Application中定义跳转映射。
Router.getInstance().openURI("http://www.g.cn"); Router.getInstance().openURI("tel://18662430000"); Router.getInstance().openURI("geo:0,0?q=31,121");
总结
最后，使用这个框架是不需要先有的程序去配置Kotlin的环境的。
未来，会考虑把这个项目的其余模块也都用Kotlin来编写，以及新功能的开发。
