SAKA'S BLOG

OKHttp(一)之Calls

Note:在我翻译这篇文章的时候OKHttp的版本是3.6.0。
这个系列的文章介绍了许多网上教程很少的拦截器,介绍了如何实现拦截请求

HTTP客户端的任务是接受您的请求并产生响应。 这在理论上很简单,但在实践中却很棘手。

Request

每个HTTP请求()包含一个URL,一个方法(例如GET或者POST),和一个头信息列表。请求可能会包含一个请求体:一种特定类型的数据流(一般是JSON格式)。

Response

响应是请求的一种回复,包含状态码(code)(200代表成功,404代表未找到该页),头信息和响应体。

重写请求体

当你想OkHttp发送HTTP请求时,你是在一个较高的级别上描述一个请求:利用这些头信息抓取这个页面的数据。为了正确性和较高的效率,OkHttp会在发送之前重写这些请求。

OkHttp会在原始请求体上添加缺少的头信息,包括Content-Length, Transfer-Encoding, User-Agent, Host, Connection, 和Content-Type。它将为transparent response compression添加一个Accept-Encoding头,除非头已经存在。 如果你有Cookie,OkHttp将添加一个Cookie头。

某些请求将有一个缓存响应。 当这个缓存的响应过时时,OkHttp可以做一个条件GET来下载更新的响应。 这需要添加如If-Modified-Since和If-None-Match的头。

重写响应体

如果使用transparent response compression,OkHttp将删除相应的响应头Content-Encoding和Content-Length,因为它们不适用于解压缩的响应主体。

如果条件GET成功,则来自网络和缓存的响应按照规范的指示合并。

跟进请求

当你请求的URl地址被移除了,网络服务器会返回一个响应码(302)来表示新的地址。OkHttp会自动重定向到新地址并重启请求。

如果响应发出授权质询,OkHttp将要求认证者(如果配置)来满足质询。 如果认证者提供凭证,则使用包含该凭证的重试请求。

重启请求

一些情况下链接会中断:池连接已过时和已断开连接,或无法访问Web服务器。 OkHttp将使用不同的路由(如果有)重试请求。

调用

通过重写,重定向,跟进和重试,你的简单请求可能会产生许多请求和响应。 OkHttp使用Call来建模满足您的请求的任务,很多中间请求和响应是必要的。 但是,如果您的URL重定向或者您转移到备用IP地址,您的代码将继续工作。

调用以两种方式之一执行

- 同步:你的线程阻塞,直到响应可读。
- 异步:将请求排入任何线程,并在响应可读时在另一个线程上调用。

可以从任何线程取消调用。 如果尚未完成,调用失败! 正在写请求主体或读取响应主体的代码,将在其调用取消时发生IOException。

调度

对于同步调用,使用自己的线程,并负责管理同时发出多少请求。 太多的同步连接浪费资源并会延迟。

对于异步调用,Dispatcher实现最大并发请求的策略。 您可以设置每个网络服务器的最大值(默认值为5)和总体值(默认值为64)。