Android路由框架Router分析详解

什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能。

路由框架的意义

Android系统已经给我们提供了api来做页面跳转,比如startActivity,为什么还需要路由框架呢?我们来简单分析下路由框架存在的意义:

  • 在一些复杂的业务场景下(比如电商),灵活性比较强,很多功能都是运营人员动态配置的,比如下发一个活动页面,我们事先并不知道具体的目标页面,但如果事先做了约定,提前做好页面映射,便可以自由配置。
  • 随着业务量的增长,客户端必然随之膨胀,开发人员的工作量越来越大,比如64K问题,比如协作开发问题。App一般都会走向组件化、插件化的道路,而组件化、插件化的前提就是解耦,那么我们首先要做的就是解耦页面之间的依赖关系。
  • 简化代码。数行跳转代码精简成一行代码。
  • 其他...

工作流程图

Router的工作流程简要如下图:

特性

Router有哪些特性或者有点呢?

  • 简单
  • 链式调用,api友好
  • 多路径支持
  • 结果回调,每次跳转都会回调跳转结果
  • 编译期处理注解,没有使用反射,不影响运行时性能
  • 除了可以使用注解定义路由,还支持手动分配路由
  • 自定义拦截器,可以对路由进行拦截,比如登录判断和埋点处理
  • 自定义路由匹配规则,相比较其他路由框架,该项目并没有写死路由的匹配规则,除了内置的几个匹配器,用户完全可以定义自己的规则
  • 支持隐式Intent跳转
  • 支持多模块使用,支持组件化开发

集成

集成过程也可参考项目主页README。

1、在项目级的build.gradle中加入依赖:

 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"
 }

其中ext中的配置是可选的,用来指定依赖的router和注解处理器的版本,默认为最新的版本。

注意,Router需要使用2.2.0及以上版本的Android gradle plugin来处理注解处理器,截至写作时,最新版本为2.3.0-beta2

2、在module级的build.gradle中使用plugin:

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

至此,集成工作就完成了,简单的两步:添加依赖插件和应用插件。

使用

1、Router需要初始化,用于初始化路由表,建议放到Application中做:

 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);

进阶

自定义路由表

Router除了可以使用注解来做映射,还支持在代码中自定义:

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

即路由表由两部分组成,一部分是注解,另一部分是手动添加的。

拦截器

Router支持拦截器的配置,比如在跳转前做登录状态的校验,

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

intercept方法返回true即表示拦截该路由,false表示不拦截。拦截器可以添加多个,依次调用,方便协作开发。

自定义路由解析规则

该功能是Router的特色功能之一。由于每个产品的业务都不一样,灵活的路由处理规则是十分必要的。用户可以借鉴Router内置的几个匹配器(Matcher),来实现自己的规则。

内置的Matcher

Router目前内置了4个Matcher,已经能适用绝大部分业务场景,优先级从高到低分别是SimpleMatcher(0x1000)SchemeMatcher(0x0100)ImplicitMatcher(0x0010)BrowserMatcher(0x0000),优先级高的Matcher会优先匹配。

自定义Matcher

自定义的Matcher需要继承Matcher抽象类,指定该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);

然后调用Router.registerMatcher(new CustomMatcher(int priority));来注册自定义的Matcher。

Matcher支持配置多个,会依次进行匹配。

其他

获取Intent

Intent intent = Router.build(uri).getIntent(context);,即可获取一个符合路由规则Intent对象,然后你可以使用这个intent来跳转,或者发一个通知。

显示log

在调试过程中,可能需要打印Router相关的log,通过Router.openLog()即可打开,建议在debug环境下打开。

总结

Router是一个十分小巧灵活的路由框架,代码设计也很优雅简洁,且完美支持组件化开发,目前仍在不断地迭代中。

源码地址为:Router_jb51.rar

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • 浅谈关于Android路由的实现

    先说一下背景,目前有需求从外部包括其他应用和WEB跳转到我们自己的APP,就这么个简单的需求-- 要实现这种外部跳转的功能,我们可以理解为打算跳转的一方有多少方式通知到APP进行相对的响应行为.所以,如果是应用之间的跳转,则有多种,你可以直接通过包名和具体的类名去打开已经exported=true的Activity,又或者直接通过Android的广播通知进行相关的APP,又或者通过自定义的URL去打开应用.但是如果涉及到Web打开外部应用的话,目前只有一种办法,那就是自定义应用的URL进行拦截,

  • Android路由框架Router分析详解

    什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能. 路由框架的意义 Android系统已经给我们提供了api来做页面跳转,比如startActivity,为什么还需要路由框架呢?我们来简单分析下路由框架存在的意义: 在一些复杂的业务场景下(比如电商),灵活性比较强,很多功能都是运营人员动态配置的,比如下发一个活动页面,我们事先并不知道具体的目标页面,但如果事先做了约定,提前做好页面映射,便可以自由配置. 随着业务量的增长,客户端必然随之膨胀,开发人员的工作量越来越大,比

  • Android WindowManger的层级分析详解

    目录 一. Window 分类 二. Window层级 (1)应用程序窗口: (2)子窗口: (3)系统窗口: (三)如何真正查看 Window 的优先级 (四) 层级高低具体分析(对比Toast以及软键盘) (五)如何定制系统层级 一. Window 分类 应用 Window(ApplicationWindow: 对应一个 Acitivity) 子 Window    (SubWindow:不能单独存在,需要依附在特定的父 Window 中,比如常见的一些 Dialog 就是一个子 Windo

  • Android路由框架ARouter分析

    一.路由方案 原生的路由方案缺点: 显式:直接的类依赖,耦合严重 隐式:规则集中式管理,协作困难 Manifest扩展性较差 跳转过程无法控制 失败无法降级 ARouter的优势: 使用注解,实现了映射关系自动注册 与 分布式路由管理 编译期间处理注解,并生成映射文件,没有使用反射,不影响运行时性能 映射关系按组分类.多级管理,按需初始化 灵活的降级策略,每次跳转都会回调跳转结果,避免StartActivity()一旦失败将会抛出运营级异常 自定义拦截器,自定义拦截顺序,可以对路由进行拦截,比如

  • Android AOP框架AspectJ使用详解

    前言 之前了解过android的AOP框架,用法主要用来打日志:现在有一个需求需要函数在新线程中执行,并且函数主体执行完之后,在UI线程返回结果.想到手写的话,每次都要new Thread的操作,比较麻烦:因此就尝试用注解的方法解决这个问题. AspectJ的使用核心就是它的编译器,它就做了一件事,将AspectJ的代码在编译期插入目标程序当中,运行时跟在其它地方没什么两样,因此要使用它最关键的就是使用它的编译器去编译代码ajc.ajc会构建目标程序与AspectJ代码的联系,在编译期将Aspe

  • Android Volley框架使用方法详解

    本文主要从两个方面对Android Volley框架的使用方法进行讲解,具体内容如下 一.网络请求 1.get方式请求数据 // 1 创建一个请求队列 RequestQueue requestQueue = Volley.newRequestQueue(VolleyActivity.this); // 2 创建一个请求 String url = "http://api.m.mtime.cn/PageSubArea/TrailerList.api"; StringRequest stri

  • Vue.js框架路由使用方法实例详解

    Vue.js框架路由使用方法实例详解 html代码: <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name='viewport' content='width=device-width,initial-

  • Android中XUtils3框架使用方法详解(一)

    xUtils简介 xUtils 包含了很多实用的android工具. xUtils 支持大文件上传,更全面的http请求协议支持(10种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响... xUitls 最低兼容android 2.2 (api level 8) 今天给大家带来XUtils3的基本介绍,本文章的案例都是基于XUtils3的API语法进行的演示.相信大家对这个框架也都了解过, 下面简单介绍下XUtils3的一些基本知识. XUtils3一共有4大功能:注解模块,网络

  • Android 网络请求框架Volley实例详解

    Android 网络请求框架Volley实例详解 首先上效果图 Logcat日志信息on Reponse Volley特别适合数据量不大但是通信频繁的场景,像文件上传下载不适合! 首先第一步 用到的RequetQueue RequestQueue.Java RequestQueue请求队列首先得先说一下,ReuqestQueue是如何对请求进行管理的...RequestQueue是对所有的请求进行保存...然后通过自身的start()方法开启一个CacheDispatcher线程用于缓存调度,开

  • Android 全局通知弹窗示例分析详解

    目录 需求分析 一.Dialog的编写 二.获取当前显示的Activity的弱引用 三.封装和使用 需求分析 如何创建一个全局通知的弹窗?如下图所示. 从手机顶部划入,短暂停留后,再从顶部划出. 首先需要明确的是: 1.这个弹窗的弹出逻辑不一定是当前界面编写的,比如用户上传文件,用户可能继续浏览其他页面的内容,但是监听文件是否上传完成还是在原来的Activity,但是Dialog的弹出是需要当前页面的上下文Context的. 2.Dialog弹窗必须支持手势,用户在Dialog上向上滑时,Dia

  • 基于mpvue搭建微信小程序项目框架的教程详解

    简介: mpvue框架对于从没有接触过小程序又要尝试小程序开发的人员来说,无疑是目前最好的选择.mpvue从底层支持 Vue.js 语法和构建工具体系,同时再结合相关UI组件库,便可以高效的实现小程序开发 前言: 本文讲述如何搭建完整的小程序项目框架,因为是第一次使用,有不完善的地方请大佬指正. 搭建内容包括: 1.使用scss语法:依赖插件sass-loader .node-sass 2.像vue一样使用路由:依赖插件 mpvue-entry 和 mpvue-router-patch 3.使用

随机推荐