通过该篇文章大家可以了解到如下几点

1. 什么是OkHttp
2. 为什么要用OkHttp
3. OkHttp使用的基本要求
4. 如何使用OkHttp
5. OkHttp内部是如何构造请求和响应的
6. 专题的后续内容

---

什么是OkHttp

HTTP协议，即超文本传输协议(Hypertext transfer protocol)。是一种详细规定了浏览器和万维网(WWW = World Wide Web)服务器之间互相通信的规则，通过因特网传送万维网文档的数据传送协议。
而OkHttp本质是一个Http客户端，我们可以通过OkHttp发送向服务方发送Http请求，然后获取相应的响应内容。

为什么要用OkHttp

在Java平台上，我们一般会使用Apache HttpClient 作为 Http 客户端去发送 Http 请求，然后再对响应进行处理，那为什么要使用OkHttp呢？

• 首先HttpClient API众多，代码复杂，而且需要用户关心资源的回收
• 而OkHttp内部结构清晰，它的请求/响应API 使用建造者模式来设计，API设计简单高效。
• 更重要的是它是一个高效的HTTP客户端，允许所有同一个主机地址的请求共享同一个socket连接，连接池减少请求延时
• 同时支持透明的GZIP压缩减少响应数据的大小
• 支持缓存响应内容，避免一些完全重复的请求

OkHttp使用的基本要求

OkHttp 适用于 Java 8+. 它有一个更加高效的I/O依赖包Okio。【详细版本要求传送门】

如何使用OkHttp

下面给出两个例子，一个是通过Get请求从一个URL中获取内容，并打印为字符串。完整代码🔗

OkHttpClient client = new OkHttpClient();

String run(String url) throws IOException {
  Request request = new Request.Builder()
      .url(url)
      .build();

  try (Response response = client.newCall(request).execute()) {
    return response.body().string();
  }
}

另一个是将数据推送到服务器端，完整代码🔗

public static final MediaType JSON
    = MediaType.get("application/json; charset=utf-8");

OkHttpClient client = new OkHttpClient();

String post(String url, String json) throws IOException {
  RequestBody body = RequestBody.create(JSON, json);
  Request request = new Request.Builder()
      .url(url)
      .post(body)
      .build();
  try (Response response = client.newCall(request).execute()) {
    return response.body().string();
  }
}

OkHttp内部是如何构造请求和响应的

当我们发送一个Http请求的时候，首先肯定是思考如何构造一个请求，而在OkHttp内部，我们只需要通过一个类Request就可以构造出我们需要的任何类型的请求,同样我们只需要通过一个类Response就可以读取到任何类型的响应。

下面是OkHttp的对请求封装的实现类Request

下面这张图第一眼看起来复杂， 其实大家只需要看最下面的Request类，它非常简单，只包含我们上面提到的url、method、headers、body和tag、cacheControl，剩下的只是该类的实例域名的实现类。

Request及其内部的实例域
其中 RequestBody是一个抽象类，下图是该类的Diagram图。
RequestBody

---

我们可以通过如下的建造者模式的方式构建我们需要的请求。

        Request request = new Request.Builder()
                .url("http://publicobject.com/helloworld.txt")
                .method("GET",formBody)
                .build();

下面是OkHttp的对请求封装的实现类Response

到目前未知，我们已经了解了OkHttp的request的内容，下面给出response的Diagram图，图中没有给出cacheControl。

response的Diagram图
从上图我们可以清楚地看到OkHttp的response是由哪些内容组成的，我们可以通过读取相应的实例域去获取我们感兴趣的响应内容。

专题的后续内容

本专题的OkHttp大致分为如下几个模块.

1. OkHttp——Calls
2. Connections
3. Interceptors
4. HTTPS
5. Event
6. Cache
   后续连载的文章会依次介绍各个模块 。