当前位置：首页 > 资讯 > 技术文档

Android路由框架Router分析详解

时间：2020-06-12 21:00 编辑：来源：阅读：
扫一扫，手机访问

摘要：Android路由框架Router分析详解

什么是路由？说简单点就是映射页面跳转关系的，当然它也包含跳转相关的一切功能。 [b]路由框架的意义[/b] Android系统已经给我们提供了api来做页面跳转，比如[code]startActivity[/code]，为什么还需要路由框架呢？我们来简单分析下路由框架存在的意义： [list] [*]在一些复杂的业务场景下（比如电商），灵活性比较强，很多功能都是运营人员动态配置的，比如下发一个活动页面，我们事先并不知道具体的目标页面，但如果事先做了约定，提前做好页面映射，便可以自由配置。[/*] [*]随着业务量的增长，客户端必然随之膨胀，开发人员的工作量越来越大，比如64K问题，比如协作开发问题。App一般都会走向组件化、插件化的道路，而组件化、插件化的前提就是解耦，那么我们首先要做的就是解耦页面之间的依赖关系。[/*] [*]简化代码。数行跳转代码精简成一行代码。[/*] [*]其他...[/*] [/list] 工作流程图 Router的工作流程简要如下图: [img]http://img.1sucai.cn/uploads/article/2018010709/20180107090151_0_38317.jpg[/img] 特性 [code]Router[/code]有哪些特性或者有点呢？ [list] [*]简单[/*] [*]链式调用，api友好[/*] [*]多路径支持[/*] [*]结果回调，每次跳转都会回调跳转结果[/*] [*]编译期处理注解，没有使用反射，不影响运行时性能[/*] [*]除了可以使用注解定义路由，还支持手动分配路由[/*] [*]自定义拦截器，可以对路由进行拦截，比如登录判断和埋点处理[/*] [*]自定义路由匹配规则，相比较其他路由框架，该项目并没有写死路由的匹配规则，除了内置的几个匹配器，用户完全可以定义自己的规则[/*] [*]支持隐式Intent跳转[/*] [*]支持多模块使用，支持组件化开发[/*] [/list] 集成集成过程也可参考项目主页[url=http://xiazai.1sucai.cn/201702/yuanma/Router_jb51.rar]README[/url]。 1、在项目级的[code]build.gradle[/code]中加入依赖:

 buildscript {
   repositories {
     jcenter()
   }
   dependencies {
     classpath 'com.android.tools.build:gradle:2.2.x ↑'
     classpath 'com.chenenyu.router:gradle-plugin:latest.integration'
   }
 }

 // Optional. Specify the dependencies version, default to the latest version.
 ext {
   ...
   routerVersion = "x.y.z"
   compilerVersion = "x.y.z"
 }

其中[code]ext[/code]中的配置是可选的，用来指定依赖的[code]router[/code]和注解处理器的版本，默认为最新的版本。注意，[code]Router[/code]需要使用2.2.0及以上版本的[code]Android gradle plugin[/code]来处理注解处理器，截至写作时，最新版本为[code]2.3.0-beta2[/code]。 2、在module级的[code]build.gradle[/code]中使用plugin：

 apply plugin: 'com.android.application/library'
 apply plugin: 'com.chenenyu.router'

至此，集成工作就完成了，简单的两步：添加依赖插件和应用插件。 [b]使用[/b] 1、[code]Router[/code]需要初始化，用于初始化路由表，建议放到[code]Application[/code]中做：

 public class App extends MultiDexApplication {
   @Override
   public void onCreate() {
     super.onCreate();
     // 初始化
     Router.initialize(this);
     // 开启log
     if (BuildConfig.DEBUG) {
       Router.openLog();
     }
   }
 }

2、添加注解

 // 单路径注解
 @Route("test")
 public class TestActivity extends Activity {
 ...
 }

 // 多路径注解，这几个注解都能打开该Activity
 @Route({"user", "example://user", "http://example.com/user"})
 public class UserActivity extends Activity {
 ...
 }

3、发起路由操作

 // 最简单的路由跳转，打开TestActivity
 Router.build("test").go(context);

 // 其他部分api
 Router.build("user")
   .requestCode(int) // 调用startActivityForResult
   .extras(bundle) // 携带跳转参数
   .addFlags(flag) // 添加标记，比如intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP)
   .anim(enter, exit) // 添加跳转动画
   .callback(calback) // 跳转结果回调
   .go(context);

[b]进阶[/b] [b]自定义路由表[/b] [code]Router[/code]除了可以使用注解来做映射，还支持在代码中自定义：

// 动态添加路由
Router.addRouteTable(new RouteTable() {
  @Override
  public void handleActivityTable(Map<String, Class<? extends Activity>> map) {
    map.put("dynamic", DynamicActivity.class);
  }
});

即路由表由两部分组成，一部分是注解，另一部分是手动添加的。 [b]拦截器[/b] [code]Router[/code]支持拦截器的配置，比如在跳转前做登录状态的校验，

Router.addRouteInterceptor(new RouteInterceptor() {
  @Override
  public boolean intercept(Context context, @NonNull Uri uri, @Nullable Bundle extras) {
    // operation.
    return false;
  }
});

[code]intercept[/code]方法返回[code]true[/code]即表示拦截该路由，[code]false[/code]表示不拦截。拦截器可以添加多个，依次调用，方便协作开发。 [b]自定义路由解析规则[/b] 该功能是[code]Router[/code]的特色功能之一。由于每个产品的业务都不一样，灵活的路由处理规则是十分必要的。用户可以借鉴[code]Router[/code]内置的几个匹配器([code]Matcher[/code])，来实现自己的规则。 [b]内置的Matcher[/b] [code]Router[/code]目前内置了4个[code]Matcher[/code]，已经能适用绝大部分业务场景，优先级从高到低分别是[code]SimpleMatcher(0x1000)[/code]、[code]SchemeMatcher(0x0100)[/code]、[code]ImplicitMatcher(0x0010)[/code]、[code]BrowserMatcher(0x0000)[/code]，优先级高的Matcher会优先匹配。 [b]自定义Matcher[/b] 自定义的Matcher需要继承[code]Matcher[/code]抽象类，指定该Matcher的优先级，并实现两个抽象方法：

// 返回true表示当前路由被该Matcher匹配，返回false则会继续匹配其他Matcher
public abstract boolean match(Context context, Uri uri, @Nullable String route, RouteOptions routeOptions);

// match方法返回true后会调用该方法，用来生成一个Intent对象
public abstract Intent onMatched(Context context, Uri uri, @Nullable Class<? extends Activity> target);

然后调用[code]Router.registerMatcher(new CustomMatcher(int priority));[/code]来注册自定义的Matcher。 Matcher支持配置多个，会依次进行匹配。 [b]其他[/b] [b]获取Intent[/b] [code]Intent intent = Router.build(uri).getIntent(context);[/code],即可获取一个符合路由规则Intent对象，然后你可以使用这个intent来跳转，或者发一个通知。显示log 在调试过程中，可能需要打印[code]Router[/code]相关的log，通过[code]Router.openLog()[/code]即可打开，建议在debug环境下打开。 [b]总结[/b] Router是一个十分小巧灵活的路由框架，代码设计也很优雅简洁，且完美支持组件化开发，目前仍在不断地迭代中。源码地址为：[url=http://xiazai.1sucai.cn/201702/yuanma/Router_jb51.rar]Router_jb51.rar[/url] 以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持编程素材网。

全部评论(0)

上一篇：Android屏蔽软键盘并且显示光标的实例详解
下一篇：android panellistview 圆角实现代码

资讯排行榜
更多>>