一、前言

OkHttp 在 Android 网络框架这一块的地位已经不言而喻了，尤其从 Android 4.4 之后，系统已经抛弃了原生的 HttpUrlConnection 的内部实现，转而是封装了 OkHttp 的实现，HttpUrlConnection 对外只是一层接口供开发者来调用。所以现在不管你是使用 HttpUrlConnection 还是 Volley，其实都是在间接使用 OkHttp，说它的出现基本上统一了 Android 的 Http 网络框架真的一点也不为过。

二、官文解读

1.概览

用官网的话来说，OkHttp 是一个用于进行 Http / Http2 通信的客户端，并且同时适用于 Android 和 Java。

当然，其还是一个非常强大而高效的网络框架，其主要特点在于：

• 对于同一个主机的所有请求，允许其在 Http / Http 2 上共享同一个套接字，这就避免了重复的 TCP 连接带来的 3 步握手的时间。
• 对于 Http 协议，其支持连接池用于减少请求延迟。
• 数据都使用了 gzip 压缩传输，从而减小网络传输 size 的大小。
• 对响应进行缓存，避免缓存有效期内重复的网络请求。
• 弱网情况下，在连接失败后，OkHttp 会自动进行重试，特别是有备用地址时还会通过备用地址进行连接。而安全上，其支持新一代的 TLS 功能，SNI 和 ALPN，如果服务器不支持的话则会主动降级到 TLS 1.0。

OkHttp的使用是很简单的，它在 request/reponse API 上采用了链式 Builder 的设计模式，使得它具备一旦构建便不可修改性。

最后，还提到它支持同步和异步请求。其实网络请求的实现原理上也是一次 I/O 通信，并且大多还是同步的 I/O。早前我们直接用 HttpUrlConnection 进行通信时根本不区分什么同步和异步，只是迫于 Android 的强制管理机制，要求网络通信不能放在 "main thread" 中进行，否则就报 crash，我们不得已才把网络请求这一段代码放到了子线程运行，最后再通过 Handler 把结果返回到主线程。所以这里说的同步和异步主要也是说实现了同步和异步的封装。当然，我们进行同步调用时，也还是不能在 "main thread" 中进行。

2.例程

Get 请求

// 构建 OkHttpClient 实例
OkHttpClient client = new OkHttpClient();

String run(String url) throws IOException {
  // 通过链式 Builder 设计提供的 Builder 构建 Request
  Request request = new Request.Builder()
      .url(url)
      .build();
  // 以下是发起一个同步请求，Response 为接收的响应结果
  Response response = client.newCall(request).execute();
  return response.body().string();
}

Post 请求

// 指定 Body 的 cotent-type 为 application/json，一般情况下都是这个
public static final MediaType JSON
    = MediaType.parse("application/json; charset=utf-8");
// 构建 OkHttpClient 实例
OkHttpClient client = new OkHttpClient();

String post(String url, String json) throws IOException {
  // 构建 Body
  RequestBody body = RequestBody.create(JSON, json);
 // 构建 Request，对于 post 请求，除了设置 url 还需要设置 body
  Request request = new Request.Builder()
      .url(url)
      .post(body)
      .build();
 // 执行一个同步的请求，响应结果在 Response 中
  Response response = client.newCall(request).execute();
  return response.body().string();
}

sample 中的请求都是同步的，其对应的异步请求为 client.newCall(request).enqueue(callback)。

3. 使用 gradle 中集成

这个就 so easy 了

compile 'com.squareup.okhttp3:okhttp:3.12.0'

三、工程概述

当我们 clone 下 OkHttp 的 github 仓库下来，会发现其里面含有非常多的小工程，这其实是一个大的 maven 工程。如果要工程化的管理以及调试，建议用 IntelliJ IDEA 或者 Eclipse 打开工程，而不要用 Android Studio 打开，最后得到的效果如下图。如果打开的下图这个样子，你就可以进行愉快的代码调式了。当然手头最好还是准备一个衬手的抓包工具，如 charles,fiddler 或者 更牛逼的 Wireshark。

image.png

从上图看 OKHttp 的核心实现库就是 okhttp 工程。作为一个优秀的框架，一定不是孤立地存在的，还有它身边的辅助工程，demo 工程等等。如下是整个工程模块的分类及简要说明。

工程模块分类图

	模块名	说明
1	benchmark	主要用于性能测试。
2	mockwebserver	mock 一个 web 服务器，方便测试。包括了 HTTP 和 HTTPS 全栈测试。
3	okhttp-dnsoverhttps	使用OkHttp在HTTPS上进行DNS实验
4	okhttp-hpacktests	hpack 测试，hapck 即头部压缩算法，主要应用在 http2 上
5	okhttp-testing-support	测试支持模块
6	sampls	例程
7	okcurl	okhttp 版本的 curl，可以测试整个 okhttp 库，包括了 http2 协议
8	okhttp-andorid-support	增强 Android 的支持
9	okhttp-apache	封装了 OkHttp 版本的 apache HttpClient 实现，未来版本中会被移除
10	okhttp-tests	单元测试
11	okhttp-urlconnection	封装了 OkHttp 版本的 HttpUrlConnection，未来版本中会被移除
12	okhttp-tls	简化 tls 使用的 API，尤其自签名证书
13	okhttp-see	实验性的用于支持服务器发送的事件。API不稳定，可能随时更改。
14	okhttp-logging-interceptor	典型的 interceptor 用例
15	bom	目前还只是一个空模块
16	websites	okhttp 站点页面
17	okhttp	okhttp 核心库的实现

四、总结

基础认知部分主要是熟悉了 OkHttp 的官网以及 OkHttp 源码的整个工程。通过对整个工程的了解，其主要目的是建立一起一个全局观。所谓站的高看的远，有了全局观之后使得我们深入到某个细节之后不致于感到迷惘。

最后，感谢你能读到并读完此文章。受限于作者水平有限，如果分析的过程中存在错误或者疑问都欢迎留言讨论。如果我的分享能够帮助到你，还请记得帮忙点个赞吧，谢谢。