BRouter 入门

实现

整体实现参考OkHttp的interceptor责任链模式，支持Router跳转中的认证，拦截，重定向，AB，（服务发现，服务注入）：类似Dagger

自定义Gradle plugin以及APT编译阶段根据注解生成代码，并将Module，Service，Task，Route meta信息输出到Json

功能

路由

1. 泛平台路由定义：支持多平台的路由定义，native，web，flutter（暂未实现），applets（暂未实现），通过RouteType指定

2. 自定义启动流程：自定义创建Intent，适用于跳转前，对一些参数的自定义处理。

3. 统一路由协议：RouteRequest对象可以互转一条统一路由协议：

   ("bilibili://video/BV1tC4y1H7yz?" +
           "-Bpt.types=native&" +
           "-Bpt.types=web&" +
           "-Bpt.flags=1&" +
           "-Bpt.prev=${Uri.encode("https://bilibili.com")}&" +
           "-Bpt.forward=${Uri.encode("https://baidu.com")}"
           
   互转
   "bilibili://video/BV1tC4y1H7yz".toBuilder()
       .routeTypes("native", "web")
       .flags(1)
       .prev("https://www.bilibili.com".toRouteRequest())
       .forward("https://baidu.com".toRouteRequest())
       .build()
           
   

4. 全局/模块/路由三级拦截器

   @Singleton
   @Services
   class CheckLoginInterceptor(private val loginService: LoginService) : RouteInterceptor {
       override fun intercept(chain: RouteInterceptor.Chain): RouteResponse {
           return if (!loginService.isLogin) {
               RouteResponse(RouteResponse.Code.UNAUTHORIZED, chain.request)
           } else {
               chain.proceed(chain.request)
           }
       }
   }
   

   CheckLoginInterceptor拦截器做了登陆校验，如果未登录会返回未认证，如果上面初始化时配置了 RouteAuthenticator，则会自动重定向到认证页，且认证后自动转发请求

5. 灵活的路由匹配/捕获规则：正则表达式，比如：

   @Routes(
       "(?<scheme>https|http)://github.com/{org_name}/{project_name}"
   )
   

   相比其他Router框架编写匹配规则稍微麻烦些

服务

1. 声明服务：类上或者静态方法（类似一个工厂方法）上声明服务
2. 消费服务：@Inject注解或BRouter.services.getService(LoginService::class.java, "v1")

模块

通过@ModuleOptions显示声明模块，不声明则隐式创建

模块注解类可选注解ModuleActivator，处理回调onCreate onPostCreate

1. 所有归属这个模块的服务，均隐式的依赖了这个模块的onCreate
2. 可以在构造函数中声明对其他模块服务的依赖
3. onCreate 与 onPostCreate 其实是特殊的 Task，因此可以在上面加TaskOptions注解来配置任务
4. ON_DEMAND 模块的 onCreate 在模块的路由或者服务第一次被获取时触发或者手动触发
5. ON_INIT 则在BRouterCore.setUp触发，均为异步

任务

一次性的，用完即毁，仅适用于启动任务，且每个Task是归属一个模块的

@TaskOptions("task2", dependencies = ["lib2.task1"], threadMode = ThreadMode.ANY)
public class Task2(@Named("v1") service: LoginService) : TaskAction {
    override fun execute(task: Task) {
        executor = Executors.newSingleThreadExecutor()
    }

    @Named("cached")
    @TaskOutput(ExecutorService::class, Executor::class)
    lateinit var executor: ExecutorService
}

构造函数可依赖服务，比较特别的是，@TaskOutput会产生服务，而且因为 Task 一次性的性质，@TaskOutput产生的服务是单例的

数据

Json文件描述Router，Service，Task，Module通过解析可用于CI/CD/自动化/数据可视化；

自定义APT：通过MetaProcessor二次转发，方便迁移其他版本的路由到BRouter中

应用

柔性降级

该仓库示例本身没有直接呈现柔性降级，但是可以结合后端RemoteConfig服务和方案中的拦截器实现柔性降级。比如：

1. Module的拦截器和RemoteConfig配置实现模块级别的降级
2. App的拦截器和RemoteConfig配置结合实现页面级别的降级（这时的拦截器类似统调中心）

路由拦截

支持App，Module以及Route自身的拦截，以及自定义的Launch方式扩展性高

具有Moudle的启动的周期，INIT，CREATE，POSTCREATE

Refer

https://github.com/bilibili/BRouter