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

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

时间: 2024-09-17 18:40:13

Android路由框架Router分析详解的相关文章

Android Volley框架使用方法详解_Android

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

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

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

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中XUtils3框架使用方法详解(一)

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

《Android多媒体应用开发实战详解:图像、音频、视频、2D和3D》——2.1节简析Android安装文件

2.1 简析Android安装文件 Android多媒体应用开发实战详解:图像.音频.视频.2D和3D 当下载并安装Android后,会在其安装目录中看到一些安装文件.了解这些文件具体是干什么用的,对于我们后面的驱动开发知识学习十分有用,所以在本节的内容中将简要介绍这些安装文件的基本知识. 2.1.1 Android SDK目录结构 安装Android SDK后,其安装目录的具体结构如图2-1所示. temp:里面包含了一些常用的文件模板. tools:包含了一些通用的工具文件. usb_dri

Android中Service(后台服务)详解

  这篇文章主要介绍了Android中Service(后台服务)详解,本文讲解了Service的概念.作用.生命周期.启动方式和代码实例等内容,需要的朋友可以参考下 1.概念: (1).Service可以说是一个在后台运行的Activity.它不是一个单独的进程,它只需要应用告诉它要在后台做什么就可以了. (2).它要是实现和用户的交互的话需要通过通知栏或者是通过发送广播,UI去接收显示. (3).它的应用十分广泛,尤其是在框架层,应用更多的是对系统服务的调用. 2.作用: (1).它用于处理一

Android中HorizontalScrollView使用方法详解_Android

由于移动设备物理显示空间一般有限,不可能一次性的把所有要显示的内容都显示在屏幕上.所以各大平台一般会提供一些可滚动的视图来向用户展示数据.Android平台框架中为我们提供了诸如ListView.GirdView.ScrollView等滚动视图控件,这几个视图控件也是我们平常使用最多的.下面介绍一下HorizontalScrollView的使用和需要注意的点:  HorizontalScrollView是一个FrameLayout  ,这意味着你只能在它下面放置一个子控件,这个子控件可以包含很多

Android高效率编码-第三方SDK详解系列(二)——Bmob后端云开发,实现登录注册,更改资料,修改密码,邮箱验证,上传,下载,推送消息,缩略图加载等功能

Android高效率编码-第三方SDK详解系列(二)--Bmob后端云开发,实现登录注册,更改资料,修改密码,邮箱验证,上传,下载,推送消息,缩略图加载等功能 我的本意是第二篇写Mob的shareSDK分享组件的,奈何需要去注册各平台的账号,还要审核,有些审核还挺久,就没办法,改为写这个Bmob了,相信大家对Bmob都是挺期待的吧,因为他作为Android后端的实现很好的支持,国内很多软件都在使用它,他的功能也是特别神奇,这里就不一一细说了,我们用实际的例子来见证他的神奇 官网:http://w