跳转至

拦截器

根据使用场景选择

  1. Interceptor: 支持三方OkHttp拦截器组件, 允许修改请求/响应信息, 可以转发请求
  2. RequestInterceptor: Net独有的轻量级拦截器, 允许修改全局请求头/请求参数, 无法转发请求

禁止无效封装

不应为全局参数/加密等封装请求方法, 应自定义拦截器/转换器来实现, 常见拦截器示例

拦截器

添加拦截器

NetConfig.initialize(Api.HOST, this) {
    addInterceptor(RefreshTokenInterceptor())
}

客户端token自动续期示例

class RefreshTokenInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        val request = chain.request()
        val response = chain.proceed(request)
        return synchronized(RefreshTokenInterceptor::class.java) {
            if (response.code == 401 && UserConfig.isLogin && !request.url.encodedPath.contains(Api.Token)) {
                val tokenInfo = Net.get(Api.Token).execute<TokenModel>() // 同步请求token
                if (tokenInfo.isExpired) {
                    // token过期抛出异常, 由全局错误处理器处理, 在其中可以跳转到登陆界面提示用户重新登陆
                    throw ResponseException(response, "登录状态失效")
                } else {
                    UserConfig.token = tokenInfo.token
                }
                chain.proceed(request)
            } else {
                response
            }
        }
    }
}

请求拦截器

轻量级拦截器(RequestInterceptor), 其Api更适合添加全局请求头/参数

NetConfig.initialize(Api.HOST, this) {
    setRequestInterceptor(object : RequestInterceptor {
        override fun interceptor(request: BaseRequest) {
            request.param("client", "Net")
            request.setHeader("token", "123456")
        }
    })
}

可以看出setRequestInterceptor仅支持一个, addInterceptor支持多个拦截器