從 ASIHTTPRequest 遷移到 AFNetworking 後,常會遇到統一添加 HTTP 標頭、流量統計、URL 重定向與同步請求等需求。若請求入口分散,直接修改成本高,此時可考慮 NSURLProtocol。
NSURLProtocol 是 URL Loading System 的擴充點。註冊後,可攔截並重新定義網路請求行為,常用於統一標頭、mock、快取、重定向與流量統計。
自定義 Protocol 需繼承 NSURLProtocol,並呼叫 registerClass 註冊。系統會在請求送出前詢問每個已註冊的 Protocol 是否能處理該請求。
canInitWithRequest 是入口,可用來過濾 http 或 https 請求,並避免重複處理。
後續需實作 canonicalRequestForRequest、requestIsCacheEquivalent、startLoading 與 stopLoading。其中 startLoading 可複製 request、添加標頭,再透過 NSURLConnection 送出。
接管請求後,需實作 NSURLConnectionDelegate 與 NSURLConnectionDataDelegate,並透過 NSURLProtocolClient 把 response、data、error 等事件回傳給系統。
第一個常見問題是在 canonicalRequestForRequest 中修改 request,容易引發遞迴呼叫與超時。實務上通常直接回傳原始 request。
第二個問題是回呼實作不完整,例如重定向時未透過 client 回傳,導致 host 錯誤或資源載入失敗。
可用 dispatch_semaphore 把 AFNetworking 請求改成同步,但若放在 UI 執行緒會造成阻塞。
另一種做法是讓 NSRunLoop 在等待期間保持運行。然而,若 RunLoop 沒有 timer 或 input source,runMode 可能立即返回,造成忙等與 CPU 過高,甚至請求超時。
解法是加入 timer 或空 port,讓 RunLoop 掛起而不空轉。