本文以 CocoaAsyncSocket 為基礎,從 TCP 連接的建立一路講到請求結果的解析與派發,梳理一套易用的 iOS 網絡層該如何分層。全文約八千字,建議留出二三十分鐘。
建立一個可靠的網絡連接(連接定義、建立與關閉、自動重連)
自定義網絡任務(協議設計、請求構造、任務抽象)
網絡任務的派發(派發、取消、多服務器切換)
合理使用請求派發器
打個電話的比方:通話前必須先接通,沒人會先講兩段單口相聲再去撥號;接通後,聽筒收數據、話筒發數據;信號斷了通常會立刻回撥;說完再掛斷。
網絡通信與此高度相似——撥號對應建立連接,回撥對應重連,掛斷對應斷開,聽筒與話筒分別對應收發。於是連接的職責邊界就很清楚了。

接口足夠見名知意,直接看實現要點:


內部由 GCDAsyncSocket 承擔實際連接。創建它需要一個 delegate 和 delegateQueue,這裡 delegate 設為自己,delegateQueue 用外部傳入或自建。由於 GCDAsyncSocket 基於 runloop 讀數據,為了不拖累 UI 流暢度,另開一個 socketThread 專門處理收發。


連接前先主動斷開舊連接;連接需要服務器地址與端口;GCDAsyncSocket 的連接方法是同步的,因此要放到 socketThread 中執行。失敗走 reconnect 重連,成功則開始讀數據並向上層拋。

談重連之前得先說心跳保活,常見的有兩種:
單向 ping:客戶端定時發心跳包,服務端收到後回一個。若客戶端遲遲收不到回覆,就判定對方離線並主動斷開。缺點是接收方處於被動,兩次心跳之間的間隔裡它無法確認對方狀態——電梯、隧道就是典型場景:連接還在,信號已不足以通信。
雙向 ping-pong:服務端發完消息後要求對端回一個心跳,約定時間內沒收到就認為此次發送失敗,斷開這條無效連接等待重連;若是重要消息,可轉由 APNS 補推。同理,客戶端發請求後約定時間內沒有回應,就作為超時錯誤返回調用方,多次超時也應主動斷連重連。
回到重連本身。若客戶端是被服務端主動踢掉,說明網絡有問題,稍後重連即可。但如果是客戶端自己斷的,除了網絡問題,還可能是服務端此刻已過載或掛掉、無力回心跳。此時若所有客戶端在同一瞬間一起重連,剛剛喘口氣的服務器會立刻被幾十萬連接再次打垮,陷入惡性循環。這正是 connect 方法裡 delayTime 要引入隨機抖動的原因。
有了自管理的 socket,上層就不必再操心連接細節,可以專注於數據收發。
TCP 是字節流,多個數據包首尾相鄰、彼此不分,直接扔過去接收端無法解析(也就是「粘包」)。所以每個包都要加上描述自身邊界的包頭。基於 TCP 的 HTTP 幫你自動加好了這些頭,直面 TCP 時則要自己處理。
一次請求分為請求頭和請求體,請求體拼在頭後。請求體就是業務參數,請求頭則至少包含三個字段:
操作類型(messageType,作用等同 HTTP 的 URL)
請求序列號(messageSerialNum,唯一標識)
請求體長度(messageContentLength,用於防粘包)
其餘字段多與業務掛鉤,比如校驗用的 checkSum、請求尾、自動登錄用的 sessionId、標識資源變化的 ETag 與 Last-Modified 等。
拼裝方式有兩類:
直接拼裝

分隔符拼裝(示例以 == 分隔)

共同點:請求頭長度固定、內部字段偏移固定,否則對端無法解析。
差異:直接拼裝是「先讀頭,按 Length 截取體,再用 checkSum 或請求尾校驗」,一旦丟包導致頭部 Length 讀錯,後續解析全部報廢,只能重連。分隔符拼裝是「讀到第一個分隔符拿到頭,再讀到下一個拿到體」,出問題就丟掉這一組;只要分隔符本身沒丟,後續解析不受影響,不必重連。
我司用的是直接拼裝。好處是實現簡單,而 TCP 本身就是可靠連接,丟包概率極低,實測多年未出問題。
自定義一個請求類,傳入頭與體,輸出排好版的數據包:

請求類型太關鍵,單獨作為必填參數;其餘非必要字段放進 HHSocketRequestHeader 以 header 傳入;請求體採用 Protocol Buffers 序列化。
這裡為三種操作各定義一個接口:心跳不帶任何信息,只需序列號;真實數據請求三個參數都要;取消請求的說明見下文。



參照 NSURLSessionTask 的思路,給每個請求一個遞增 identifier 作為序列號;心跳、服務器推送等則定義在 HHSocketRequestType 枚舉中。這樣解析出序列號後,就能依據編號規則判斷這回包是數據響應、心跳還是推送。這裡預留了 50 個序列號方便擴展。
HHDataFormatter 負責 int 與 data 的互轉,內部同一套實現,對外多開幾個接口以提高可讀性。順帶一提,int 轉 data 要注意大小端(網絡字節序與主機字節序)問題。
請求只描述「要做什麼」,不知道「何時發起、何時取消、完成後做什麼」。所以再抽一層 HHSocketTask:

它負責管理任務狀態、執行結果回調,並對外暴露派發與取消接口。
套路和 HTTP 篇一致:一個派發器持有執行中的任務以便支持取消,派發完成後移除。同樣定義單例:

嚴格說,一個 socket 連接理應對應一個接收端和一張派發表,但我司只有一條數據請求連接,這裡就先偷懶用屬性存了。

與 HTTP 篇幾乎一致,只多了 task.client = self 這一行,作用下文說明。派發本質上就是調用 task.resume。







Task.resume:先判斷任務是否可用(是否已被外部取消),可用則置為派發中,然後調用 self.client.resumeTask。self.client 就是派發時賦值的那一行。
HHSocketClient.resumeTask:判斷 socket 連接狀態,可用則把序列化好的數據包寫入連接;響應會在 socket:didReadData: 中接收。連接不可用則直接走 completeWithResponseData:error:。
socket:didReadData:先重置心跳計時,把新數據追加到 self.readData,再調用 getParsedResponseData 嘗試解出完整包。若解出,先查序列號是否在 dispatchTable 中:在,說明是響應,交給 Task 處理;不在,則是推送或心跳,各自處理。
getParsedResponseData:依據拼裝規則從響應頭中取出 msgLength,按此長度截出完整數據包。
completeWithResponseData:error:所有請求的最終歸宿。先判斷任務狀態,未取消則用 HHSocketResponseFormatter 拆包,取出 responseCode 判斷服務端能否處理(正常 200,否則走 taskErrorWithResponeCode:),再用 adler32 校驗數據完整性,最後執行 completeWithResult:error。
completeWithResult:error:執行初始化時傳入的 completionHandler。執行前會先經過 HHSocketClient,在那裡把 task 從派發表移除,然後才調用業務回調,並在回調結束後置 nil 以打破循環引用。
把數據流動串起來:
發起:調用方傳參 → HHSocketRequest 序列化 → HHSocketTask 把 data 交給 HHSocketClient → 由 HHSocket 真正發出
響應:HHSocket 回調 HHSocketClient → 判斷類型與完整性 → 完整包交給 Task → Task 拆包解析出 result 與 error → 執行 completionHandler → 派發器移除 Task → 調用方拿到結果
與 HTTP 篇的派發器相比,這裡有三點差異值得強調:
第一,持有 Task 的時機提前了。不是在 dispatchTask: 時才持有,而是 Task 一建立就持有。因為並非所有 Task 都會走 dispatchTask:,若在此處才持有,那些提前完成的任務就不會被記錄,響應回來時會被誤判為已處理。
第二,通用錯誤處理放在了 Task 而不是派發器。HTTP 派發的是系統 Task,數據要先經系統加工才輪到我們,我們對結果不滿意才有了二次處理。而 Socket 的 Task 第一道加工者就是我們自己,Task 本來就要拆包解析,順手格式化錯誤理所當然。更根本的原因是:派發器根本不知道什麼算正確返回、什麼算錯誤,它只負責派發與取消。所謂職責分離,就是只做自己該知道的事。
第三,部分方法沒有出現在 .h 中。OC 沒有友元概念,所以 Task.setClient、HHSocket.resumeTask 這類只給特定類使用的接口,我統一放在對應的 xxx+friend.h 裡。

HTTP 的一次任務本身就對應一條連接,取消直接斷連即可。但我們所有任務都跑在同一條連接上,直接斷開副作用太大。的解法是在 HHSocketRequest 中提供一個生成「取消請求」的接口:若某個操作很重要,收到 HHNetworkTaskErrorCanceled 時就補發一條取消指令告知服務端;若只是好友列表、用戶信息之類的展示接口,什麼都不用做,等響應回來在 completeWithResponseData:error: 裡直接丟棄。
超時處理就是 ping-pong 思路:任務發起後開 timer,約定時間內返回則取消 timer,否則到點自動取消任務並返回 HHNetworkTaskErrorTimeOut。


邏輯與 HTTP 篇相同,只是多加了一條:連續多次連接失敗後也執行服務器切換。

由於 Task 的初始化方式變了,APIConfiguration 相應調整;APIManager、TaskGroup、APIRecorder 的使用方式與規範則與 HTTP 篇完全一致。
HHSocket:負責連接,發生在子線程以保證 UI 流暢,內建自動重連,對外暴露切換服務器接口
HHSocketRequest:請求的描述類,管理本地與服務端序列號,輸出格式化好的數據包
HHDataFormatter:序列化工具類
HHSocketTask:任務的描述類,管理狀態、格式化結果,暴露派發與取消接口
HHSocketClient:派發器,記錄所有在服役的任務,必要時切換服務器
TCP 是個龐大的話題,寫了這麼多也只觸及皮毛。相比服務端,客戶端本就輕鬃不少,加上 GCDAsyncSocket 這類優秀開源庫的加持,才有可能搭起一套自己的長連接框架。現在的實現還很簡陋,但聊勝於無,權當一次青春的嘗試。