OKHttp源码解析（七）：CallServerInterceptor 与 HttpCodec 深度解析

Android

2023-10-03 22:40:33

CallServerInterceptor：请求与响应的桥梁

CallServerInterceptor 是 OKHttp 中的核心拦截器之一，主要负责在客户端和服务器之间建立通信通道，并负责在流上传输请求数据以及处理接收到的响应数据。它在整个请求响应流程中扮演着至关重要的角色。

CallServerInterceptor 的工作流程

建立连接 ：在拦截过程中，CallServerInterceptor 会首先检查是否有可用的连接，如果没有，则会创建一个新的连接。这包括建立 TCP 连接、执行握手协议以及协商加密参数等操作。
发送请求数据 ：一旦连接建立，CallServerInterceptor 便会开始发送请求数据。它会将请求体和其他请求头信息写入连接的输出流中，并等待服务器的响应。
处理服务器响应 ：当服务器收到请求并处理后，会将响应数据发送回客户端。CallServerInterceptor 会从连接的输入流中读取响应数据，并将其解析成 HTTP 响应对象。
验证响应 ：CallServerInterceptor 会对服务器返回的响应进行验证，包括检查响应状态码、响应头信息以及响应体内容等。如果响应不符合预期，则会抛出异常或采取其他适当的措施。
关闭连接 ：在处理完响应数据后，CallServerInterceptor 会关闭连接，以释放资源并为后续请求做好准备。

HttpCodec：编码与解码的专家

HttpCodec 是 OKHttp 中负责编码和解码 HTTP 消息的组件。它将请求和响应数据编码成字节流，以便在网络上传输，并在接收后解码成相应的对象。

HttpCodec 的编码与解码流程

编码请求数据 ：在发送请求之前，HttpCodec 会将请求体和其他请求头信息编码成字节流。编码方式根据请求的 Content-Type 头信息而定，例如，对于文本数据，可以使用 UTF-8 编码，对于二进制数据，可以使用 Base64 编码。
解码响应数据 ：当收到服务器响应后，HttpCodec 会将响应体和其他响应头信息解码成相应的对象。解码方式也根据响应的 Content-Type 头信息而定，与请求数据编码方式相同。
处理特殊情况 ：对于某些特殊情况，HttpCodec 会采取特殊的处理方式。例如，如果请求或响应中包含压缩数据，HttpCodec 会自动进行解压缩操作；如果请求或响应中包含分块传输编码，HttpCodec 会将分块数据重新组合成完整的响应体。

自定义 CallServerInterceptor 和 HttpCodec

在某些情况下，我们需要自定义 CallServerInterceptor 和 HttpCodec 以满足特定的需求。例如，我们可以自定义 CallServerInterceptor 来实现连接池，或者自定义 HttpCodec 来支持新的编码格式。

自定义 CallServerInterceptor

为了自定义 CallServerInterceptor，我们需要创建一个新的拦截器类并实现相应的拦截方法。例如，我们可以创建一个名为 MyCallServerInterceptor 的拦截器类，并在其中实现 intercept 方法如下：

public class MyCallServerInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();

        // 在这里可以对请求进行处理，例如添加自定义请求头

        Response response = chain.proceed(request);

        // 在这里可以对响应进行处理，例如检查响应状态码

        return response;
    }
}

然后，我们在创建 OkHttpClient 对象时，将 MyCallServerInterceptor 添加到拦截器列表中即可。

OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(new MyCallServerInterceptor())
        .build();

自定义 HttpCodec

为了自定义 HttpCodec，我们需要创建一个新的 HttpCodec 类并实现相应的编码和解码方法。例如，我们可以创建一个名为 MyHttpCodec 的 HttpCodec 类，并在其中实现 encodeRequest 和 decodeResponse 方法如下：

public class MyHttpCodec implements HttpCodec {
    @Override
    public RequestBody createRequestBody(MediaType contentType, Buffer content) {
        // 在这里可以对请求体进行编码

        return new RequestBody() {
            @Override
            public MediaType contentType() {
                return contentType;
            }

            @Override
            public void writeTo(BufferedSink sink) throws IOException {
                // 在这里可以将编码后的请求体写入到 sink 中
            }
        };
    }

    @Override
    public ResponseBody createResponseBody(MediaType contentType, Buffer content) {
        // 在这里可以对响应体进行解码

        return new ResponseBody() {
            @Override
            public MediaType contentType() {
                return contentType;
            }

            @Override
            public void writeTo(BufferedSink sink) throws IOException {
                // 在这里可以将解码后的响应体写入到 sink 中
            }
        };
    }
}

然后，我们在创建 OkHttpClient 对象时，将 MyHttpCodec 设置为默认的 HttpCodec 即可。

OkHttpClient client = new OkHttpClient.Builder()
        .httpCodec(new MyHttpCodec())
        .build();

总结

CallServerInterceptor 和 HttpCodec 是 OKHttp 中两个非常重要的组件，它们共同协作，实现了客户端与服务器之间的通信。通过理解它们的功能和工作原理，我们可以更好地使用 OKHttp 来进行网络请求。此外，我们还可以通过自定义 CallServerInterceptor 和 HttpCodec 来满足特定的需求，从而扩展 OKHttp 的功能。