轉(zhuǎn)載請(qǐng)注明出處 http://www.reibang.com/p/cccdf48ea8d4 (作者：韓棟)
本文為譯文憔晒，由于譯者水平有限，歡迎拍磚妒御，讀者也可以閱讀原文
【OkHttp3-基本用法，OkHttp3-使用進(jìn)階（Recipes），OkHttp3-請(qǐng)求器（Calls）辆床，OkHttp3-連接（Connections），OkHttp3-攔截器（Interceptor）】
OkHttp客戶端負(fù)責(zé)接收應(yīng)用程序發(fā)出的請(qǐng)求桅狠，并且從服務(wù)器獲取響應(yīng)返回給應(yīng)用程序讼载。理論聽起來(lái)十分簡(jiǎn)單，但是在實(shí)踐中往往會(huì)出現(xiàn)很多意想不到的因素中跌。
請(qǐng)求 (Request)
每一個(gè)Http請(qǐng)求都包含一個(gè)URL和一個(gè)請(qǐng)求方式（比如Get或者Post）咨堤，以及一些請(qǐng)求頭信息。請(qǐng)求也有可能包含一個(gè)請(qǐng)求主體：當(dāng)一個(gè)數(shù)據(jù)流存在指定的content type類型的請(qǐng)求頭時(shí)漩符。
響應(yīng) (Responses)
服務(wù)器根據(jù)請(qǐng)求向你的應(yīng)用程序返回響應(yīng)一喘，此響應(yīng)包含了一個(gè)狀態(tài)碼（比如200表示請(qǐng)求成功，404表示請(qǐng)求失斒缺）凸克、響應(yīng)頭、以及可能包含的響應(yīng)主體闷沥。
重寫請(qǐng)求 (Rewriting Requests)
OkHttp所發(fā)出去的每個(gè)Http請(qǐng)求都是高等級(jí)的：`“fetch me this URL with these headers.”萎战。為了請(qǐng)求的正確性和高效性，OkHttp在數(shù)據(jù)傳輸之前會(huì)自動(dòng)重寫你的請(qǐng)求舆逃。
OkHttp可以自動(dòng)為你的請(qǐng)求添加一些請(qǐng)求所沒有的請(qǐng)求頭蚂维，包括Content-Length戳粒、Transfer-Encoding、User-Agent虫啥、Host享郊、Connection，以及Content-Type孝鹊。 如果你的原生請(qǐng)求中沒有定義Accept-Encoding類型炊琉，那么OkHtpp會(huì)自動(dòng)為請(qǐng)求添加Accept-Encoding類型為Gzip，以此希望服務(wù)端能返回壓縮過的數(shù)據(jù)又活。如果應(yīng)用程序中存在Cookies苔咪，那么OkHttp將會(huì)自動(dòng)將它們添加到你的請(qǐng)求的Cookie頭部信息中。
OkHttp會(huì)將一些請(qǐng)求的響應(yīng)緩存起來(lái)柳骄。當(dāng)其中的一個(gè)緩存過期時(shí)团赏，OkHttp將會(huì)發(fā)送一個(gè)帶有特定的請(qǐng)求頭信息（比如If-Modified-Since或者If-None-Match），并且以Get方式請(qǐng)求去重新從服務(wù)器上獲取數(shù)據(jù)耐薯，并且如果所獲取的新數(shù)據(jù)與舊的緩存數(shù)據(jù)不一致舔清，OkHttp將新的數(shù)據(jù)保存覆蓋掉舊的緩存。
重寫響應(yīng) (Rewriting Responses)
如果響應(yīng)主體是經(jīng)過壓縮處理曲初，那么OkHttp會(huì)自動(dòng)將響應(yīng)頭部中的Content-Encoding和Content-Length去掉体谒，因?yàn)樗鼈儾⒉贿m用于解壓縮響應(yīng)主體的操作。
如果一個(gè)請(qǐng)求方法為Get的網(wǎng)絡(luò)請(qǐng)求執(zhí)行成功臼婆，那么正常情況下從服務(wù)器返回的響應(yīng)將會(huì)和緩存進(jìn)行合并抒痒。
跟蹤請(qǐng)求 (Follow-up Requests)
當(dāng)你所請(qǐng)求的主機(jī)的URL發(fā)生改變時(shí)，服務(wù)器將會(huì)返回一個(gè)為302的響應(yīng)狀態(tài)碼以及新的URL信息颁褂。OkHttp將會(huì)根據(jù)這個(gè)URL進(jìn)行重定向操作故响，并且再次向新的URL發(fā)送請(qǐng)求獲取數(shù)據(jù)。
當(dāng)你發(fā)送請(qǐng)求時(shí)颁独，服務(wù)器可能會(huì)返回一個(gè)響應(yīng)告訴你需要進(jìn)行身份基本認(rèn)證彩届，那么OkHttp此時(shí)會(huì)自動(dòng)告訴Authenticator去解決這個(gè)認(rèn)證問題，當(dāng)然誓酒，Authenticator需要你自己進(jìn)行配置樟蠕。Authenticator處理身份認(rèn)證通過時(shí)會(huì)獲取到認(rèn)證成功憑證，OkHttp會(huì)攜帶著它再次向服務(wù)器發(fā)送原來(lái)的請(qǐng)求丰捷。
重試請(qǐng)求 (Retrying Requests)
有的時(shí)候會(huì)發(fā)生連接失斉髂：可能連接池過期而導(dǎo)致連接斷開，或者請(qǐng)求的服務(wù)器無(wú)法找到病往。OkHttp將會(huì)不斷嘗試不同的可用線路去發(fā)送請(qǐng)求捣染。
請(qǐng)求器 (Calls)
通過重寫、重定向停巷、跟蹤以及重試耍攘，你發(fā)送的一個(gè)簡(jiǎn)單的請(qǐng)求可能會(huì)變成需要發(fā)送多個(gè)請(qǐng)求以及接收多次響應(yīng)之后才能獲得最后的想要的響應(yīng)榕栏。OkHttp會(huì)將這些全部請(qǐng)求以及響應(yīng)（你的一個(gè)請(qǐng)求任務(wù)）塑造成一個(gè)Call對(duì)象，然而請(qǐng)求過程中所發(fā)生的多次請(qǐng)求以及響應(yīng)是必須的蕾各。但是通常情況下中間請(qǐng)求及響應(yīng)工作不會(huì)很多扒磁！令人欣慰的是，無(wú)論發(fā)生URL重定向還是因?yàn)榉?wù)器出現(xiàn)問題而向一個(gè)備用IP地址再次發(fā)送請(qǐng)求的情況式曲，你的代碼都會(huì)一直正常運(yùn)行妨托。
執(zhí)行Call有兩種方式：
- 同步：請(qǐng)求和處理響應(yīng)發(fā)生在同一線程。并且此線程會(huì)在響應(yīng)返回之前會(huì)一直被堵塞吝羞。
- 異步：請(qǐng)求和處理響應(yīng)發(fā)生在不同線程兰伤。將發(fā)送請(qǐng)求操作發(fā)生在一個(gè)線程，并且通過回調(diào)的方式在其他線程進(jìn)行處理響應(yīng)钧排。（一般在子線程發(fā)送請(qǐng)求敦腔，主線程處理響應(yīng)）
Calls可以在任何線程被取消。當(dāng)這個(gè)Call尚未執(zhí)行結(jié)束時(shí)恨溜，執(zhí)行取消操作將會(huì)直接導(dǎo)致此Call失敺巍！當(dāng)一個(gè)Call被取消時(shí)糟袁，無(wú)論是寫入請(qǐng)求主體或者讀取響應(yīng)主體的代碼操作判族，都會(huì)拋出一個(gè)IOException異常。
調(diào)度者 (Dispatch)
對(duì)于在同步線程中執(zhí)行Call而言系吭，你最好創(chuàng)建子線程并且手動(dòng)管理你所發(fā)出的并發(fā)請(qǐng)求五嫂。因?yàn)樘嗖l(fā)連接浪費(fèi)資源，以及可能會(huì)導(dǎo)致發(fā)生一些不好的小問題肯尺。
對(duì)于異步線程執(zhí)行Call而言，Dispactcher實(shí)現(xiàn)了一個(gè)限制最大并發(fā)的接口躯枢。你也可以自定義設(shè)置對(duì)于每臺(tái)主機(jī)的最大并發(fā)數(shù)（默認(rèn)為5）则吟，以及總的并發(fā)數(shù)（默認(rèn)為64）。
