OkHttp 精讲：RetryAndFollowUpInterceptor

原文出处

标题：OkHttp 精讲：RetryAndFollowUpInterceptor

作者：Android轮子哥

原文链接：OkHttp 精讲：RetryAndFollowUpInterceptor - 简书

前言

• 本文章所使用的 OkHttp 源码版本：3.12.10

源码解析

• 那么问题来了，一个拦截器的源码那么多，我们该从何入手呢？

• 我们可以看到拦截器所实现的一个 Interceptor 接口，里面只有一个 intercept 方法，那么我们就从这个方法开始入手

• 一眼望去，最吸引我们眼球的，莫属这个 while 循环，因为我们之前讲过，拦截器执行原理就是使用了递归，现在怎么还在递归里面使用循环了呢？到底是在做什么骚操作？

• 在这里我们可以看到，当前拦截器将请求通过拦截链传递给下一个拦截器

• 有意思的地方是，在这个传递过程中，有两个 catch 块，这两个 catch 块的结果都是要么抛出异常，要么继续循环

• 那么什么情况下会抛异常呢？我们可以通过源码看出，它是通过调用 recover 方法来决定是否抛出异常，接下来让我们看看这个方法是干什么用的

• 看完这个方法，我相信大多数人的反应跟我第一次看的时候一样，还是没看懂这个方法有什么用
• 看不懂源码不要紧，可以看源码上面的注释，但注释是英文的也是看不懂该怎么办？可以翻译成中文再看。有一句老话说得好，只要思想不滑坡，方法总比困难多。阻挡我们前进的不是困难本身，而是我们内心的恐惧，而唯一的方法就是战胜它

• 通过这些注释，我们可以得出，这个方法用于判断请求是否还能被恢复，如果可以的话就进行重新请求，如果不行就直接抛出异常给上层
• 这个便是 OkHttp 重试机制，如果错误不是致命的，就对请求进行重试，正如这个拦截器的名字一样， RetryAndFollowUpInterceptor，Retry 是重试的意思，And 是和的意思，那么 FollowUp 是什么意思？

• 光靠这个单词的意思我们并不能得出答案，接下来我们将通过剩余的源码来揭晓答案

• 这个方法看着很可疑，看名字跟我们想知道的 followUp 作用有很大关系，让我们先进去这个方法里面看看

• 看完的第一个感觉还是懵，不过还是用老方法来解决这个问题

• 处理客户端超时大家都懂，这里不再做过多解释，但是重定向，这个专业术语可能对于做 App 开发的人来说还是很陌生，在这里我给大家举个栗子，大家可以打开这个链接：http://www.baidu.com，然后再仔细瞅瞅网址变了没？
• 没错，我们明明输入的是 http://www.baidu.com，但是却跳转到 https://www.baidu.com 上了
• 如果你听不懂我想表达什么，那么说明这个栗子还是不够生动形象，我再举一个栗子
• 大家可以打开这个链接：https://www.xiaomi.com，是不是就变成了 https://www.mi.com ？
• 这种功能就叫做请求重定向，属于 Http 协议的内容
• 如果你看完了整个 OkHttp 的源码，其实不难发现，如果对 Http 协议不够了解，很多源码基本没办法看懂
• 那么我们又该如何了解 Http 协议呢？
• 让我们回顾一下 Http 的组成部分，Http 报文大致分为两种：请求报文和响应报文，分别对应着 OkHttp 中的 Request 和 Response 类，其中请求报文内容大致分为请求头、Body（文件流），响应报文内容大致分为响应头、响应码、Body（文件流）
• 请求的 Body 就是我们传入的表单参数或者文件流，而响应的 Body 就是后台返回给我们的文本或者文件流，这块属于业务，和 Http 协议并无太大关系，在这里我们先简单了解一下请求头、响应头、响应码，在这里我们可以参考以下这两个对照表

• • HTTP响应头和请求头信息对照表
  • HTTP状态码对照表

• 关于请求重定向这块的源码，必须要对响应码的有一定的了解，所以我们先简单回顾一下响应码的区间和类型

• • 100-199：请求处理中
  • 200-299：请求被接受（例如：200 请求成功）
  • 300-399：请求被重定向（例如：307 地址重定向）
  • 400-499：客户端请求参数错误（例如：403 请求被拒绝，404 请求地址不存在）
  • 500-599：服务器解析请求发生错误（例如：500 服务器出错，503 接口出错）

• 我们可以得出，请求重定向的响应码区间在 300-399，那么我们只看这个区间响应码的源码

• 这段代码是什么意思，我相信大部分人都不能理解，这块的响应码是 307 和 308，那么让我们回顾一下刚刚看过的响应码表，看看这个 307 到底是什么意思？

状态码	含义
307	请求的资源现在临时从不同的 URI 响应请求。由于这样的重定向是临时的，客户端应当继续向原有地址发送以后的请求。只有在 Cache-Control 或 Expires 中进行了指定的情况下，这个响应才是可缓存的。新的临时性的URI 应当在响应的 Location 域中返回。除非这是一个 HEAD 请求，否则响应的实体中应当包含指向新的URI 的超链接及简短说明。因为部分浏览器不能识别307响应，因此需要添加上述必要信息以便用户能够理解并向新的 URI 发出访问请求。如果这不是一个 GET 或者 HEAD 请求，那么浏览器禁止自动进行重定向，除非得到用户的确认，因为请求的条件可能因此发生变化。

• 敲黑板，划重点：如果这不是一个 GET 或者 HEAD 请求，那么浏览器禁止自动进行重定向
• 意思很明显了，如果服务器返回 307 或 308，那么如果当前的请求方式不是 GET 或 HEAD，那么本次的重定向请求就会被客户端拒绝
• 在这里我们默认它就是符合要求的，然后我们接着往下面看

这里解释一下 switch 语法，如果 case 块中没有 break 或 return，那么它就会往下一个 case 块执行，直到下一个 case 块中有 break 或 return 才会跳出整个 switch。

• 会先判断我们在 OkHttpClient 有没有禁止重定向，有的话也会直接拒绝本次的重定向请求

• 这个是啥？我相信大多数人看完都愣了一下，那么这个 Location 的响应头到底是什么呢？接下来让我们回顾一下刚刚看过的请求头和响应头对照表

名称	说明	示例
Location	用来重定向接收方到非请求URL的位置来完成请求或标识新的资源	Location: Android轮子哥 - 简书

• 如果说你还是不能理解，那只能建议你打开：http://www.baidu.com
• 目的不是让你百度一下，而是先在一个空网页上打开浏览器的开发者选项，然后再打开这个网址

• 看到这里，我相信大家都应该明白了，既然是重定向，唯一不能少的就是重定向的地址

• 重新对请求头进行封装，然后返回给拦截器

源码总结

• RetryAndFollowUpInterceptor 主要作用有两个：重试和重定向
• 重试则是 OkHttp 自身的机制，如果请求失败了，那么会在这上面会判断这个错误是不是致命，如果不是的话就会对请求进行重试，否则就会抛出异常给上层。
• 重定向则是 Http 协议的一部分内容，OkHttp 选择将这一部分的逻辑放置到这个拦截器中，当服务器返回 3 开头的响应码时，会先判断当前是否禁用了请求重定向，有的话就不进行重定向，如果没有的话就会从响应头中取 Location 字段的值作为重定向地址，然后将这个地址重新封装到 Request 对象中，最后将新的 Request 对象返回给上层进行重新请求。
• 无论是重试还是重定向，它们都有一个共同的特点，都可以进行重新请求，所以它们才会被放在同一个拦截器中。