OKHttp攔截器-請求服務(wù)器攔截器

CallServerInterceptor請求服務(wù)攔截器,這是OKHttp最后一個默認(rèn)的攔截器,當(dāng)與服務(wù)建立好連接之后,就可以進(jìn)行真正的網(wǎng)絡(luò)請求了朝群。利用exchange發(fā)出請求到服務(wù)器并且解析生成Response

@Throws(IOException::class)
  override fun intercept(chain: Interceptor.Chain): Response {
    val realChain = chain as RealInterceptorChain
    val exchange = realChain.exchange!!
    val request = realChain.request
    val requestBody = request.body
    val sentRequestMillis = System.currentTimeMillis()

    exchange.writeRequestHeaders(request)

    var invokeStartEvent = true
    var responseBuilder: Response.Builder? = null
    if (HttpMethod.permitsRequestBody(request.method) && requestBody != null) {
      // If there's a "Expect: 100-continue" header on the request, wait for a "HTTP/1.1 100
      // Continue" response before transmitting the request body. If we don't get that, return
      // what we did get (such as a 4xx response) without ever transmitting the request body.
      if ("100-continue".equals(request.header("Expect"), ignoreCase = true)) {
        exchange.flushRequest()
        responseBuilder = exchange.readResponseHeaders(expectContinue = true)
        exchange.responseHeadersStart()
        invokeStartEvent = false
      }
      if (responseBuilder == null) {
        if (requestBody.isDuplex()) {
          // Prepare a duplex body so that the application can send a request body later.
          exchange.flushRequest()
          val bufferedRequestBody = exchange.createRequestBody(request, true).buffer()
          requestBody.writeTo(bufferedRequestBody)
        } else {
          // Write the request body if the "Expect: 100-continue" expectation was met.
          val bufferedRequestBody = exchange.createRequestBody(request, false).buffer()
          requestBody.writeTo(bufferedRequestBody)
          bufferedRequestBody.close()
        }
      } else {
        exchange.noRequestBody()
        if (!exchange.connection.isMultiplexed) {
          // If the "Expect: 100-continue" expectation wasn't met, prevent the HTTP/1 connection
          // from being reused. Otherwise we're still obligated to transmit the request body to
          // leave the connection in a consistent state.
          exchange.noNewExchangesOnConnection()
        }
      }
    } else {
      exchange.noRequestBody()
    }

    if (requestBody == null || !requestBody.isDuplex()) {
      exchange.finishRequest()
    }
    if (responseBuilder == null) {
      responseBuilder = exchange.readResponseHeaders(expectContinue = false)!!
      if (invokeStartEvent) {
        exchange.responseHeadersStart()
        invokeStartEvent = false
      }
    }
    var response = responseBuilder
        .request(request)
        .handshake(exchange.connection.handshake())
        .sentRequestAtMillis(sentRequestMillis)
        .receivedResponseAtMillis(System.currentTimeMillis())
        .build()
    var code = response.code
    if (code == 100) {
      // Server sent a 100-continue even though we did not request one. Try again to read the actual
      // response status.
      responseBuilder = exchange.readResponseHeaders(expectContinue = false)!!
      if (invokeStartEvent) {
        exchange.responseHeadersStart()
      }
      response = responseBuilder
          .request(request)
          .handshake(exchange.connection.handshake())
          .sentRequestAtMillis(sentRequestMillis)
          .receivedResponseAtMillis(System.currentTimeMillis())
          .build()
      code = response.code
    }

    exchange.responseHeadersEnd(response)

    response = if (forWebSocket && code == 101) {
      // Connection is upgrading, but we need to ensure interceptors see a non-null response body.
      response.newBuilder()
          .body(EMPTY_RESPONSE)
          .build()
    } else {
      response.newBuilder()
          .body(exchange.openResponseBody(response))
          .build()
    }
    if ("close".equals(response.request.header("Connection"), ignoreCase = true) ||
        "close".equals(response.header("Connection"), ignoreCase = true)) {
      exchange.noNewExchangesOnConnection()
    }
    if ((code == 204 || code == 205) && response.body?.contentLength() ?: -1L > 0L) {
      throw ProtocolException(
          "HTTP $code had non-zero Content-Length: ${response.body?.contentLength()}")
    }
    return response
  }

首先會調(diào)用exchange.writeRequestHeaders(request)將請求頭寫入到緩存中(這時候還沒有發(fā)送給服務(wù)器),然后立即判斷請求頭中的參數(shù)Expect: 100-continue

var responseBuilder: Response.Builder? = null
    if (HttpMethod.permitsRequestBody(request.method) && requestBody != null) {
      // If there's a "Expect: 100-continue" header on the request, wait for a "HTTP/1.1 100
      // Continue" response before transmitting the request body. If we don't get that, return
      // what we did get (such as a 4xx response) without ever transmitting the request body.
      if ("100-continue".equals(request.header("Expect"), ignoreCase = true)) {
        exchange.flushRequest()
        responseBuilder = exchange.readResponseHeaders(expectContinue = true)
        exchange.responseHeadersStart()
        invokeStartEvent = false
      }
      if (responseBuilder == null) {
        if (requestBody.isDuplex()) {
          // Prepare a duplex body so that the application can send a request body later.
          exchange.flushRequest()
          val bufferedRequestBody = exchange.createRequestBody(request, true).buffer()
          requestBody.writeTo(bufferedRequestBody)
        } else {
          // Write the request body if the "Expect: 100-continue" expectation was met.
          val bufferedRequestBody = exchange.createRequestBody(request, false).buffer()
          requestBody.writeTo(bufferedRequestBody)
          bufferedRequestBody.close()
        }
      } else {
        exchange.noRequestBody()
        if (!exchange.connection.isMultiplexed) {
          // If the "Expect: 100-continue" expectation wasn't met, prevent the HTTP/1 connection
          // from being reused. Otherwise we're still obligated to transmit the request body to
          // leave the connection in a consistent state.
          exchange.noNewExchangesOnConnection()
        }
      }
    } else {
      exchange.noRequestBody()
    }

這個請求頭代表了在發(fā)送請求體之前需要和服務(wù)器確定是否愿意接受客戶端發(fā)送的請求體中符。所以 permitsRequestBody判斷為是否會攜帶請求體的方式(POST)潜圃,如果命中if,則會先給服務(wù)器發(fā)起一次查詢是否愿意接收請求體舟茶,這時候如果服務(wù)器愿意會響應(yīng)100(沒有響應(yīng)體,responseBuilder即為null)堵第。這時候才能夠繼續(xù)發(fā)送剩余請求數(shù)據(jù)吧凉。

但是如果服務(wù)器不同意接受請求體,那么我們就需要標(biāo)記該連接不能再被復(fù)用踏志,調(diào)用noNewExchangesOnConnection()關(guān)閉相關(guān)的Socket阀捅。最終調(diào)用exchange.flushRequest()將請求發(fā)送到服務(wù)器。

接下來

if (responseBuilder == null) {
  responseBuilder = exchange.readResponseHeaders(expectContinue = false)!!
  if (invokeStartEvent) {
    exchange.responseHeadersStart()
    invokeStartEvent = false
  }
}
var response = responseBuilder
    .request(request)
    .handshake(exchange.connection.handshake())
    .sentRequestAtMillis(sentRequestMillis)
    .receivedResponseAtMillis(System.currentTimeMillis())
    .build()

這時 responseBuilder 的情況即為:

  1. POST方式請求针余,請求頭中包含 Expect 饲鄙,服務(wù)器允許接受請求體,并且已經(jīng)發(fā)出了請求體圆雁, responseBuilder 為null;

  2. POST方式請求忍级,請求頭中包含 Expect ,服務(wù)器不允許接受請求體伪朽, responseBuilder 不為null

  3. POST方式請求轴咱,未包含 Expect ,直接發(fā)出請求體烈涮, responseBuilder 為null;

  4. POST方式請求朴肺,沒有請求體, responseBuilder 為null;

  5. GET方式請求坚洽, responseBuilder 為null;

對應(yīng)上面的5種情況戈稿,讀取響應(yīng)頭并且組成響應(yīng) Response ,注意:此 Response 沒有響應(yīng)體讶舰。同時需要注意的是鞍盗,如果服務(wù)器接受 Expect: 100-continue 這是不是意味著我們發(fā)起了兩次 Request 需了?那此時的響應(yīng)頭是第一次查詢服務(wù)器是否支持接受請求體的,而不是真正的請求對應(yīng)的結(jié)果響應(yīng)橡疼。所以緊接著:

var code = response.code
if (code == 100) {
  // Server sent a 100-continue even though we did not request one. Try again to read the actual
  // response status.
  responseBuilder = exchange.readResponseHeaders(expectContinue = false)!!
  if (invokeStartEvent) {
    exchange.responseHeadersStart()
  }
  response = responseBuilder
      .request(request)
      .handshake(exchange.connection.handshake())
      .sentRequestAtMillis(sentRequestMillis)
      .receivedResponseAtMillis(System.currentTimeMillis())
      .build()
  code = response.code

如果響應(yīng)是100援所,這代表了是請求 Expect: 100-continue 成功的響應(yīng),需要馬上再次讀取一份響應(yīng)頭欣除,這才是真正的請求對應(yīng)結(jié)果響應(yīng)頭住拭。接下來創(chuàng)建response并返回結(jié)果:

response = if (forWebSocket && code == 101) {
  // Connection is upgrading, but we need to ensure interceptors see a non-null response body.
  response.newBuilder()
      .body(EMPTY_RESPONSE)
      .build()
} else {
  response.newBuilder()
      .body(exchange.openResponseBody(response))
      .build()
}
if ("close".equals(response.request.header("Connection"), ignoreCase = true) ||
    "close".equals(response.header("Connection"), ignoreCase = true)) {
  exchange.noNewExchangesOnConnection()
}
// 如果沒有響應(yīng)體,但Content-Length請求頭大于0历帚,拋出異常
if ((code == 204 || code == 205) && response.body?.contentLength() ?: -1L > 0L) {
  throw ProtocolException(
      "HTTP $code had non-zero Content-Length: ${response.body?.contentLength()}")
}
return response

forWebSocket代表websocket的請求滔岳,我們直接進(jìn)入else,這里就是讀取響應(yīng)體數(shù)據(jù)挽牢。然后判斷請求和服務(wù)器是不是都希望長連接谱煤,一旦有一方指明close,那么就需要關(guān)閉socket禽拔。而如果服務(wù)器返回204/205刘离,一般情況而言不會存在這些返回碼,但是一旦出現(xiàn)這意味著沒有響應(yīng)體睹栖,但是解析到的響應(yīng)頭中包含Content-Lenght且不為0硫惕,這表響應(yīng)體的數(shù)據(jù)字節(jié)長度。此時出現(xiàn)了沖突野来,直接拋出協(xié)議異常恼除!

總結(jié)

在這個攔截器中就是完成HTTP協(xié)議報(bào)文的封裝與解析。現(xiàn)在OKHttp的源碼基本就完了

整個OkHttp功能的實(shí)現(xiàn)就在這五個默認(rèn)的攔截器中曼氛,所以先理解攔截器模式的工作機(jī)制是先決條件豁辉。這五個攔截器分別為: 重試攔截器、橋接攔截器舀患、緩存攔截器徽级、連接攔截器、請求服務(wù)攔截器聊浅。每一個攔截器負(fù)責(zé)的工作不一樣灰追,就好像工廠流水線,最終經(jīng)過這五道工序狗超,就完成了最終的產(chǎn)品弹澎。

但是與流水線不同的是,OkHttp中的攔截器每次發(fā)起請求都會在交給下一個攔截器之前干一些事情努咐,在獲得了結(jié)果之后又干一些事情苦蒿。整個過程在請求向是順序的,而響應(yīng)向則是逆序渗稍。

當(dāng)用戶發(fā)起一個請求后佩迟,會由任務(wù)分發(fā)起 Dispatcher 將請求包裝并交給重試攔截器處理团滥。

  1. 重試攔截器在交出(交給下一個攔截器)之前,負(fù)責(zé)判斷用戶是否取消了請求报强;在獲得了結(jié)果之后灸姊,會根據(jù)響應(yīng)碼判斷是否需要重定向,如果滿足條件那么就會重啟執(zhí)行所有攔截器秉溉。

  2. 橋接攔截器在交出之前力惯,負(fù)責(zé)將HTTP協(xié)議必備的請求頭加入其中(如:Host)并添加一些默認(rèn)的行為(如:GZIP壓縮);在獲得了結(jié)果后召嘶,調(diào)用保存cookie接口并解析GZIP數(shù)據(jù)父晶。

  3. 緩存攔截器顧名思義,交出之前讀取并判斷是否使用緩存弄跌;獲得結(jié)果后判斷是否緩存甲喝。

  4. 連接攔截器在交出之前,負(fù)責(zé)找到或者新建一個連接铛只,并獲得對應(yīng)的socket流埠胖;在獲得結(jié)果后不進(jìn)行額外的處理。

  5. 請求服務(wù)器攔截器進(jìn)行真正的與服務(wù)器的通信淳玩,向服務(wù)器發(fā)送數(shù)據(jù)直撤,解析讀取的響應(yīng)數(shù)據(jù)。在經(jīng)過了這一系列的流程后凯肋,就完成了一次HTTP請求。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末汽馋,一起剝皮案震驚了整個濱河市侮东,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌豹芯,老刑警劉巖悄雅,帶你破解...
    沈念sama閱讀 218,682評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異铁蹈,居然都是意外死亡宽闲,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,277評論 3 395
  • 文/潘曉璐 我一進(jìn)店門握牧,熙熙樓的掌柜王于貴愁眉苦臉地迎上來容诬,“玉大人,你說我怎么就攤上這事沿腰±劳剑” “怎么了?”我有些...
    開封第一講書人閱讀 165,083評論 0 355
  • 文/不壞的土叔 我叫張陵颂龙,是天一觀的道長习蓬。 經(jīng)常有香客問我纽什,道長,這世上最難降的妖魔是什么躲叼? 我笑而不...
    開封第一講書人閱讀 58,763評論 1 295
  • 正文 為了忘掉前任芦缰,我火速辦了婚禮,結(jié)果婚禮上枫慷,老公的妹妹穿的比我還像新娘让蕾。我一直安慰自己,他們只是感情好流礁,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,785評論 6 392
  • 文/花漫 我一把揭開白布涕俗。 她就那樣靜靜地躺著,像睡著了一般神帅。 火紅的嫁衣襯著肌膚如雪再姑。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,624評論 1 305
  • 那天找御,我揣著相機(jī)與錄音元镀,去河邊找鬼。 笑死霎桅,一個胖子當(dāng)著我的面吹牛栖疑,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播滔驶,決...
    沈念sama閱讀 40,358評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼遇革,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了揭糕?” 一聲冷哼從身側(cè)響起萝快,我...
    開封第一講書人閱讀 39,261評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎著角,沒想到半個月后揪漩,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,722評論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡吏口,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年奄容,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片产徊。...
    茶點(diǎn)故事閱讀 40,030評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡昂勒,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出舟铜,到底是詐尸還是另有隱情叁怪,我是刑警寧澤,帶...
    沈念sama閱讀 35,737評論 5 346
  • 正文 年R本政府宣布深滚,位于F島的核電站奕谭,受9級特大地震影響涣觉,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜血柳,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,360評論 3 330
  • 文/蒙蒙 一官册、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧难捌,春花似錦膝宁、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,941評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至击敌,卻和暖如春介返,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背沃斤。 一陣腳步聲響...
    開封第一講書人閱讀 33,057評論 1 270
  • 我被黑心中介騙來泰國打工圣蝎, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人衡瓶。 一個月前我還...
    沈念sama閱讀 48,237評論 3 371
  • 正文 我出身青樓徘公,卻偏偏與公主長得像,于是被迫代替她去往敵國和親哮针。 傳聞我的和親對象是個殘疾皇子关面,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,976評論 2 355

推薦閱讀更多精彩內(nèi)容