手撸一个 Router 框架(下):路由拦截机制

前言

上篇我们介绍了 APT 在 Router 框架中的使用,通过注解处理器搜集路由信息,本篇我们来聊一下 Router 的运行机制。

为什么要用拦截器?

我们先看一下路由的使用场景

服务端下发一个链接,首先我们需要判断这个链接是否在路由表中,如果是则取出对应的页面信息,否则需要判断该链接是否支持支持内置浏览器打开,经过层层过滤,最终得到目标页面。这其中可能还要插入一些通用参数,有没有感觉和 OkHttp 的一次网络请求很相似?

使用拦截器,可以自由的插入一些自定义逻辑,使我们的路由更加灵活。

拦截器原理

先来看一张调用图

引用自 https://juejin.im/post/6844903885476216840

有没有觉得拦截器和 Android 触摸机制很相似,区别是拦截器可以直接终止链式调用,返回结果,而触摸事件则必须经过层层传递,最终返回。

实现拦截器层层调用主要是通过 Chain 这个链式调用

interface Interceptor {
    fun intercept(chain: Chain): Response

    interface Chain {
        fun request(): Request

        fun proceed(request: Request): Response

        fun call(): Call
    }
}

注:此处省略了部分方法

拦截器需要实现 intercept 方法,提供一个 chain 参数

Chain 中的 request 方法可以获得请求实体,根据请求信息可以直接返回 Response,也可以通过 proceed 方法把请求交给下一个拦截器处理。

下面来看一下 Chain 的实现

class RealInterceptorChain(
        private val interceptors: List,
        private val index: Int,
        private val request: Request,
        private val call: Call
) : Interceptor.Chain {
    private var calls: Int = 0

    override fun call(): Call {
        return call
    }

    override fun request(): Request {
        return request
    }

    override fun proceed(request: Request): Response {
        if (index >= interceptors.size) throw AssertionError()

        calls++

        // Call the next interceptor in the chain.
        val next = RealInterceptorChain(interceptors, index + 1, request, call)
        val interceptor = interceptors[index]
        val response = interceptor.intercept(next)

        // Confirm that the next interceptor made its required call to chain.proceed().
        if (response == null && index + 1 < interceptors.size && next.calls != 1) {
            throw IllegalStateException("router interceptor " + interceptor
                    + " must call proceed() exactly once")
        }

        // Confirm that the intercepted response isn't null.
        if (response == null) {
            throw NullPointerException("interceptor $interceptor returned null")
        }

        return response
    }
}

注:此处省略了部分代码

构造函数:

  • interceptors 所有连接器集合
  • index 拦截器执行序号
  • request 请求实体
  • call 请求执行者

逻辑主要在 proceed 这个方法里

  1. 首先判断 index 是否溢出,溢出直接报错
  2. 然后将 index + 1,构造下一个调用链,执行拦截请求。这里就可以做到链式循环调用
  3. 最后是做结果校验,返回最终结果

简单地几行代码就实现了链式调用,就是这么简单。

源码

查看源码

总结

本文主要介绍拦截器的实现原理,希望对大家有帮助。

你可能感兴趣的:(手撸一个 Router 框架(下):路由拦截机制)