一、前言
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。
从上图看 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 源码的整个工程。通过对整个工程的了解，其主要目的是建立一起一个全局观。所谓站的高看的远，有了全局观之后使得我们深入到某个细节之后不致于感到迷惘。
最后，感谢你能读到并读完此文章。受限于作者水平有限，如果分析的过程中存在错误或者疑问都欢迎留言讨论。如果我的分享能够帮助到你，还请记得帮忙点个赞吧，谢谢。
