转载请注明出处 http://www.jianshu.com/p/cccdf48ea8d4 (作者：韩栋)
本文为译文，由于译者水平有限，欢迎拍砖，读者也可以阅读原文
【OkHttp3-基本用法，OkHttp3-使用进阶（Recipes），OkHttp3-请求器（Calls），OkHttp3-连接（Connections），OkHttp3-拦截器（Interceptor）】

---

OkHttp客户端负责接收应用程序发出的请求，并且从服务器获取响应返回给应用程序。理论听起来十分简单，但是在实践中往往会出现很多意想不到的因素。

请求 (Request)

每一个Http请求都包含一个URL和一个请求方式（比如Get或者Post），以及一些请求头信息。请求也有可能包含一个请求主体：当一个数据流存在指定的content type类型的请求头时。

响应 (Responses)

服务器根据请求向你的应用程序返回响应，此响应包含了一个状态码（比如200表示请求成功，404表示请求失败）、响应头、以及可能包含的响应主体。

重写请求 (Rewriting Requests)

OkHttp所发出去的每个Http请求都是高等级的：`“fetch me this URL with these headers.”。为了请求的正确性和高效性，OkHttp在数据传输之前会自动重写你的请求。

OkHttp可以自动为你的请求添加一些请求所没有的请求头，包括Content-Length、Transfer-Encoding、User-Agent、Host、Connection，以及Content-Type。 如果你的原生请求中没有定义Accept-Encoding类型，那么OkHtpp会自动为请求添加Accept-Encoding类型为Gzip，以此希望服务端能返回压缩过的数据。如果应用程序中存在Cookies，那么OkHttp将会自动将它们添加到你的请求的Cookie头部信息中。

OkHttp会将一些请求的响应缓存起来。当其中的一个缓存过期时，OkHttp将会发送一个带有特定的请求头信息（比如If-Modified-Since或者If-None-Match），并且以Get方式请求去重新从服务器上获取数据，并且如果所获取的新数据与旧的缓存数据不一致，OkHttp将新的数据保存覆盖掉旧的缓存。

重写响应 (Rewriting Responses)

如果响应主体是经过压缩处理，那么OkHttp会自动将响应头部中的Content-Encoding和Content-Length去掉，因为它们并不适用于解压缩响应主体的操作。

如果一个请求方法为Get的网络请求执行成功，那么正常情况下从服务器返回的响应将会和缓存进行合并。

跟踪请求 (Follow-up Requests)

当你所请求的主机的URL发生改变时，服务器将会返回一个为302的响应状态码以及新的URL信息。OkHttp将会根据这个URL进行重定向操作，并且再次向新的URL发送请求获取数据。

当你发送请求时，服务器可能会返回一个响应告诉你需要进行身份基本认证，那么OkHttp此时会自动告诉Authenticator去解决这个认证问题，当然，Authenticator需要你自己进行配置。Authenticator处理身份认证通过时会获取到认证成功凭证，OkHttp会携带着它再次向服务器发送原来的请求。

重试请求 (Retrying Requests)

有的时候会发生连接失败：可能连接池过期而导致连接断开，或者请求的服务器无法找到。OkHttp将会不断尝试不同的可用线路去发送请求。

请求器 (Calls)

通过重写、重定向、跟踪以及重试，你发送的一个简单的请求可能会变成需要发送多个请求以及接收多次响应之后才能获得最后的想要的响应。OkHttp会将这些全部请求以及响应（你的一个请求任务）塑造成一个Call对象，然而请求过程中所发生的多次请求以及响应是必须的。但是通常情况下中间请求及响应工作不会很多！令人欣慰的是，无论发生URL重定向还是因为服务器出现问题而向一个备用IP地址再次发送请求的情况，你的代码都会一直正常运行。

执行Call有两种方式：

• 同步：请求和处理响应发生在同一线程。并且此线程会在响应返回之前会一直被堵塞。
• 异步：请求和处理响应发生在不同线程。将发送请求操作发生在一个线程，并且通过回调的方式在其他线程进行处理响应。（一般在子线程发送请求，主线程处理响应）

Calls可以在任何线程被取消。当这个Call尚未执行结束时，执行取消操作将会直接导致此Call失败！当一个Call被取消时，无论是写入请求主体或者读取响应主体的代码操作，都会抛出一个IOException异常。

调度者 (Dispatch)

对于在同步线程中执行Call而言，你最好创建子线程并且手动管理你所发出的并发请求。因为太多并发连接浪费资源，以及可能会导致发生一些不好的小问题。

对于异步线程执行Call而言，Dispactcher实现了一个限制最大并发的接口。你也可以自定义设置对于每台主机的最大并发数（默认为5），以及总的并发数（默认为64）。