OkHttp 源码解读（中）：揭秘拦截器执行流程与对应关系

2023-10-19 11:06:21







在上一篇文章中，我们重点介绍了 OkHttp 的连接池复用机制、高并发分发以及拦截器设计。然而，我们并没有深入探讨每个拦截器在框架中的具体作用。因此，本篇文章将对每个拦截器的执行流程及其对应的关系进行详细阐述。

## 拦截器的执行流程

拦截器是 OkHttp 网络请求处理过程中的一个关键组件。它允许开发人员在请求发送到服务器之前或从服务器返回响应之后对请求和响应进行修改或处理。OkHttp 框架提供了多种内置的拦截器，如 LoggingInterceptor、CacheInterceptor、CookieInterceptor 等，以便开发人员能够轻松地扩展 OkHttp 的功能。

拦截器的执行流程通常如下：

1. 当客户端调用 OkHttpClient.newCall() 方法创建一个请求调用对象时，OkHttp 会创建一个 InterceptorChain 对象，其中包含了请求调用对象和一个拦截器列表。
2. InterceptorChain 对象会依次调用列表中的每个拦截器。
3. 每个拦截器都会检查请求对象，并可以修改它或返回一个新的请求对象。
4. 拦截器也可以选择中断请求处理过程，并抛出一个异常。
5. 当所有拦截器都执行完成后，InterceptorChain 对象会调用 OkHttpClient.execute() 方法将请求发送到服务器。
6. 服务器返回响应后，InterceptorChain 对象会依次调用列表中的每个拦截器，以便对响应进行修改或处理。
7. 最后，InterceptorChain 对象将处理后的响应返回给客户端。

## 拦截器的对应关系

OkHttp 框架提供了多种内置的拦截器，每个拦截器都有其特定的作用和执行顺序。下表列出了 OkHttp 中常见的拦截器及其对应的执行顺序：

| 拦截器 | 执行顺序 | 作用 |
|---|---|---|
| LoggingInterceptor | 1 | 记录请求和响应的详细信息 |
| CacheInterceptor | 2 | 处理请求和响应的缓存 |
| CookieInterceptor | 3 | 处理请求和响应的 Cookie |
| GzipInterceptor | 4 | 对请求和响应进行 GZIP 压缩和解压缩 |
| RetryInterceptor | 5 | 在网络错误的情况下重试请求 |
| AuthenticatorInterceptor | 6 | 处理请求的身份验证 |

需要注意的是，拦截器的执行顺序是可以自定义的。开发人员可以根据自己的需求调整拦截器的执行顺序，以实现特定的功能。

## 拦截器的使用示例

以下是一个使用 OkHttp 拦截器的示例：

```java
OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new LoggingInterceptor())
    .addInterceptor(new CacheInterceptor())
    .addInterceptor(new CookieInterceptor())
    .build();

Request request = new Request.Builder()
    .url("https://example.com")
    .build();

Response response = client.newCall(request).execute();