HTTP客戶端的職責(zé)是接收請(qǐng)求產(chǎn)出響應(yīng)，理論上簡(jiǎn)單但實(shí)踐中卻棘手。
Request
每個(gè)HTTP請(qǐng)求包含一個(gè)URL，一個(gè)方法(像GET或POST)，以及請(qǐng)求頭列表。Request也可能包含主體：一個(gè)特定內(nèi)容類型的數(shù)據(jù)流。
Response
Response使用一個(gè)code(像200代表成功或404代表沒有找到)，響應(yīng)頭頭列表以及一個(gè)可選的主體應(yīng)答請(qǐng)求。
重寫Request
當(dāng)你提供給OkHttp一個(gè)HTTP請(qǐng)求時(shí)，你會(huì)深度描述這個(gè)請(qǐng)求：“fetch me this URL with these headers”。為了正確性和效率，OkHttp會(huì)在請(qǐng)求發(fā)送前進(jìn)行重寫。
OkHttp可能添加原始請(qǐng)求缺省的頭，包括Content-Length，Transfer-Encoding，User-Agent，Host，Connection和Content-Type。除非Accept-Encoding頭已經(jīng)存在，否則它會(huì)添加一個(gè)支持透明壓縮。如果你已得到cookies，OkHttp也會(huì)使用它們添加一個(gè)Cookie頭。
有些請(qǐng)求將會(huì)有一個(gè)緩存的響應(yīng)。當(dāng)緩存的響應(yīng)不新鮮時(shí)，OkHttp可以執(zhí)行一個(gè)有條件的GET來下載一個(gè)更新后的響應(yīng)(如果這個(gè)響應(yīng)比緩存的新鮮)。這個(gè)需要添加像If-Modified-Since和If-None-Match這樣的請(qǐng)求頭。
重寫Response
如果使用了透明壓縮，OkHttp會(huì)丟棄相應(yīng)的響應(yīng)頭Content-Encoding和Content-Length，因?yàn)樗鼈儾贿m用于解壓后的響應(yīng)body。
如果一個(gè)有條件的GET執(zhí)行成功，從網(wǎng)絡(luò)獲取的響應(yīng)和緩存會(huì)按規(guī)則進(jìn)行合并。
跟進(jìn)Request
當(dāng)你請(qǐng)求的URL被移動(dòng)了，服務(wù)器會(huì)返回一個(gè)像302這樣的響應(yīng)碼來指出文檔的新URL。OkHttp會(huì)跟進(jìn)這個(gè)重定向來獲取最終的響應(yīng)。
如果響應(yīng)發(fā)出了授權(quán)挑戰(zhàn)，OkHttp會(huì)詢問Authenticator(如果配置了一個(gè))來滿足這個(gè)挑戰(zhàn)。如果authenticator提供了一個(gè)證書，請(qǐng)求會(huì)帶著這個(gè)證書重試。
Request重試
有時(shí)連接會(huì)失敗：連接池過期并且失去連接，或者服務(wù)器本身不能訪問到。如果有一個(gè)可用的不同的路由，OkHttp會(huì)重試這個(gè)請(qǐng)求。
Calls
有了重寫，重定向，跟進(jìn)和重試，你簡(jiǎn)單的請(qǐng)求可能產(chǎn)生多個(gè)請(qǐng)求和響應(yīng)。OkHttp會(huì)使用Call來模化滿足請(qǐng)求的任務(wù)，然而中間的請(qǐng)求和響應(yīng)是必要的。通常它們不是很多。但是，知道你的代碼在URL重定向后可以繼續(xù)工作或你可以使用備用IP地址容錯(cuò)是令人欣慰的。
Call執(zhí)行有兩種方式：
- Synchronous：線程會(huì)阻塞直到響應(yīng)可讀。
- Asynchronous：在一個(gè)線程中入隊(duì)請(qǐng)求，當(dāng)你的響應(yīng)可讀時(shí)在另外一個(gè)線程獲取回調(diào)。
請(qǐng)求可以從任何線程取消。如果請(qǐng)求還沒完成，會(huì)使請(qǐng)求失敗。當(dāng)請(qǐng)求取消了，寫請(qǐng)求主體和讀響應(yīng)主體的代碼會(huì)遇到IOException。
請(qǐng)求分發(fā)
對(duì)于同步調(diào)用，你使用的是自己的線程并對(duì)管理你同時(shí)創(chuàng)建多少請(qǐng)求負(fù)責(zé)。太多的并發(fā)連接浪費(fèi)資源，太少會(huì)造成延遲。
對(duì)于異步調(diào)用，Dispatcher實(shí)現(xiàn)了最大并發(fā)請(qǐng)求的策略。你可以設(shè)置每個(gè)服務(wù)器最大值(默認(rèn)是5)和所有最大值(默認(rèn)是64)。
原文鏈接：
https://github.com/square/okhttp/wiki/Calls
OkHttp官方文檔系列文章：
