wiki翻译
Calls
HTTP 客户端的工作是接收你的 request 然后返回 response。理论虽然简单的但是在实际应用中却很困难。
请求(Request)
每一个 HTTP 请求都包含一个 URL,一个请求方法(例如 GET,POST),和多个的请求头。可能包含一个请求体(一个特殊组织形式的数据流)。
应答(Response)
请求的应答包含响应码(例如:200 代表成功,404 代表资源未找到),响应头和响应体(可选)。 ###重写 Request 当用 OkHttp 发送一个 HTTP 请求时,你会在更高的层面描述 Request:“用这些请求头去抓取这个URL”。为了高效且精确,OkHttp 会在发送前重写你的 Request。 OkHttp 会添加原始 Request 中没有的请求头,这些请求头包括:Content-Length
,Transfer-Encoding
,User-Agent
,Host
,Connection
,和Content-Type
。为了透明的 Response 它将添加Accept-Encoding
除非它(Accept-Encoding
)已经包含在请求头里面了。OkHttp 还会添加Cookie
请求头。
一些 request 包含一个缓存的 Response,当这个缓存的 Response 过期时 OkHttp 发送一次有条件的 GET 请求,如果它是新的那么旧的缓存将被替换,这些需要添加类似If-Modified
或If-None-Match
的请求头。
重写 Response
如果透明压缩被使用,OkHttp 将丢弃Content-Encoding
或者Content-Length
响应头,因为它们不适用于解压缩的请求体。 如果一个有条件的 GET 请求成功了,从网络获取的响应和缓存将会按照指示的规范合并。
Follow-up Requests
当你请求的 URL 改动时,服务器将会返回一个响应码(302)来重定向这个文件的新 URL。OkHttp 将会根据重定向的 URL 取回最终的 Response。 如果 Response 返回授权改变,OkHttp 将会查询 Authenticator 来满足这个改变(如果配置)。如果 Authenticator 制订了一个凭证,那么这个凭证也会包含在请求中。
Request 重试
不管是连接池过时导致的连接失败还是服务器本身不能访问导致的失败。OkHttp 都会从另一个地址重新请求(当前地址不可达)。
Calls
在 rewrites, redirects, Follow-up 和 retries 之后,你的 request 可能已经产生了大量的 request 和 response。OkHttp 通过Call
模块化任务来满足你的请求,这可能会产生必要的中间 request 和 response。一般来讲不会很多。但欣慰的是它使你的代码正常工作即使你的 URL 被重定向或者 IP 地址故障需要转移到另外一个。 Calls 有两种执行模式:
- 同步:在请求响应之前会阻塞线程
- 异步:在任意线程将 request 入队,请求响应时在其他线程执行回调
Calls 也可以从任意线程被取消,这将取消还没完成的 Call。当 Call 被取消时,向请求体写内容的代码和从响应体读内容的代码会报IOException
调度
对于同步执行的 Call,使用自定义的线程你就要管理这些同步请求。同步连接越多使用资源也越多,网络延时越低。 对于异步执行的 Call,调度器的实现了最大同步请求的策略,你可以设置每个 IP 的最大请求(默认是 5)和所有请求的最大数(默认是 64)。