5步教你快速写一个android Router路由框架

router路由框架

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

前言

网上大片的路由框架实在太多了，实现的方式都大同小异，通过注解实现路由表；但是在多module开发的时候怎么合并路由表，不同的框架有着自己的解决方案。

arouter：通过类查找进行合并路由表。

activityrouter：通过注解进行路由表合并。

路由框架的意义

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

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

特性

router有哪些特性或者优点呢？

1. 基于注解，使用方便，源码简洁
2. 链式调用，api友好
3. 多路径支持
4. 结果回调，每次跳转都会回调跳转结果
5. 编译期处理注解，不影响运行时性能
6. 除了可以使用注解定义路由，还支持手动分配路由
7. 自定义拦截器，可以对路由进行拦截，比如登录判断和埋点处理
8. 自定义路由匹配规则，相比较其他路由框架，该项目并没有限制路由的写法，除了内置的几个匹配器，用户完全可以定义自己的规则
9. 支持隐式intent跳转
10. 支持多模块使用，支持组件化开发
11. 不仅支持注解activity，还支持注解fragment
12. 支持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>

源码地址：https://github.com/waws80/router

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