5步教你快速写一个android Router路由框架
Router路由框架
什么是路由？说简单点就是映射页面跳转关系的，当然它也包含跳转相关的一切功能。
前言
网上大片的路由框架实在太多了，实现的方式都大同小异，通过注解实现路由表；但是在多module开发的时候怎么合并路由表，不同的框架有着自己的解决方案。
ARouter：通过类查找进行合并路由表。
ActivityRouter：通过注解进行路由表合并。
路由框架的意义
Android系统已经给我们提供了api来做页面跳转，比如startActivity，为什么还需要路由框架呢？我们来简单分析下路由框架存在的意义：
- 在一些复杂的业务场景下，灵活性比较强，很多功能都是动态配置的，比如下发一个活动页面，我们事先并不知道具体的目标页面，但如果事先做了约定，提前做好页面映射，便可以自由配置。
- 随着业务量的增长，客户端必然随之膨胀，开发人员的工作量越来越大，比如64K问题，比如协作开发问题。App一般都会走向组件化的道路，而组件化的前提就是解耦，那么我们首先要做的就是解耦页面之间的依赖关系。
- 简化代码。数行跳转代码精简成一行代码。
特性
Router有哪些特性或者优点呢？
- 基于注解，使用方便，源码简洁
- 链式调用，api友好
- 多路径支持
- 结果回调，每次跳转都会回调跳转结果
- 编译期处理注解，不影响运行时性能
- 除了可以使用注解定义路由，还支持手动分配路由
- 自定义拦截器，可以对路由进行拦截，比如登录判断和埋点处理
- 自定义路由匹配规则，相比较其他路由框架，该项目并没有限制路由的写法，除了内置的几个匹配器，用户完全可以定义自己的规则
- 支持隐式Intent跳转
- 支持多模块使用，支持组件化开发
- 不仅支持注解Activity，还支持注解Fragment
- 支持Kotlin
开始
对于路由表的合并我采用了ActivityRouter的方案，进行注解合并路由表。
1.源码:
if (!hasModules && !hasModule){
//普通app createrAppRouterHelper();
}
if (hasModule){
//保存每个module中的路由表 createrModuleHelper(moduleName);
}
if (hasModules){
//合并每个module中的路由表 createrRouterHelper(moduleNames);
}
2.用法：
app:
@Module("app")
@Modules({"app","module"})
public class App extends Application{
...
}
module:
@Module("module")
@Path("module")
public class ModuleActivity extends AppCompatActivity {
...
}
3.备注：非多module开发以上直接省略直接初始化路由即可
初始化
Router.init(this.getApplicationContext());//bixu Router.debug(true);//开启debug模式
页面跳转
程序内部界面之间跳转 通过 path 查找路由表中 对应的Activity 进行页面跳转。
外部跳转程序内部 通过 uri 拦截 Activity 对uri进行拦截处理并最终通过路由表查找 path进行跳转。
1.用法
基本用法
Router.getInstance().path("second");
Router.getInstance().action(MediaStore.ACTION_IMAGE_CAPTURE);
Router.getInstance().uri("https://www.waws.top/module?id=2&name=haha");
okhttp式用法
//同步Request request = new Request.Builder(this).path("second").build();
Response response = Router.getInstance().newCall(request).execute();
//异步request = new Request.Builder(this)
.path("second")
.responseCode(100)
.resultCallBack(new ResultCallBack() {
@Override
public void next(int resultCode, Intent data) {
RouterLog.d("resultCode:"+resultCode+"\ndata:"+data.getStringExtra("tag"));
}
})
.addOption(ActivityOptions.makeSceneTransitionAnimation(this,bt,"share").toBundle())
.build();
Router.getInstance().skipIntecepter().newCall(request)
.enqueue(new RouterCallBack() {
@Override
public void next(Response response) {
RouterLog.d(response.toString());
}
});
拦截Activity onActivityResult 使用了代理Fragment进行动态拦截，有兴趣的可以看源码，地址在下边
拦截器
支持全局拦截并支持降级操作
Router.addIntecepter(new RouterIntecepter() {
@Override
public Request chain(Request request) {
//TODO:
return request;
}
@Override
public void onLost(String msg) {
//TODO:
Log.d("App", "onLost: "+msg);
}
@Override
public void onSuccess() {
//TODO:
Log.d("App", "onSuccess: ");
}
});
外部跳转app内部进行如下配置
<activity android:name=".DispatcherActivity">
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.BROWSABLE"/>
<category android:name="android.intent.category.DEFAULT"/>
<!-- start -->
<!-- 修改如下data信息即可 -->
<data android:scheme="http" android:host="www.waws.top"/>
<data android:scheme="https" android:host="www.waws.top"/>
<data android:scheme="router" android:host="www.waws.top"/>
<!-- end -->
</intent-filter></activity>
上一篇：Android触摸事件和mousedown、mouseup、click事件之间的关系
栏 目：Android代码
下一篇：Android ViewPager无限循环滑动并可自动滚动完整实例
本文标题：5步教你快速写一个android Router路由框架
本文地址：http://www.codeinn.net/misctech/56201.html
