一、前言

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 工程等等。如下是整个工程模块的分类及简要说明。

四、总结

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

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