您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

XMNetworking 網絡庫的設計與使用

編輯:iOS 開發基礎

XMNetworking:輕量而完整的 iOS 網絡解決方案

XMNetworking 是團隊開源的網絡庫,基於 AFNetworking 3.0 封裝,以 XMCenter 為中心管理 XMRequest。它適合普通請求、上傳、下載、批量與鏈式請求,並可透過 XMEngine 隔離底層依賴,方便日後替換或自定義底層網絡邏輯。

主要特性

XMNetworking 的設計目標是簡單易用,同時覆蓋大多數網絡請求場景。它支援 RESTful Server API,可配置公共 Server URL、Header、Parameter,也可透過 Block 注入自定義響應處理邏輯,例如模型轉換、業務錯誤碼判斷與網絡緩存。

此外,它支援批量請求、鏈式請求、取消未完成請求、自動重試失敗請求,並整合 AFNetworking 的安全策略與網絡可連接性檢查。

系統要求

iOS 7.0 以上,Xcode 7.3 或更高版本。

安裝方式

CocoaPods

在 Podfile 中加入 XMNetworking,再執行 pod install 或 pod update。

注意:XMNetworking 已包含 AFNetworking 3.1.0 源碼,工程中的 Podfile 不要再添加 AFNetworking,否則會衝突。

Carthage

Carthage 是去中心化依賴管理工具,會自動編譯依賴庫並以 framework 形式提供。

安裝完成後,在 Cartfile 中加入對應內容。

然後執行 carthage update --platform ios,將生成的 XMNetworking.framework 拖入工程。同樣不要重複生成 AFNetworking.framework。

手動安裝

下載 XMNetworking 子文件夾的所有內容,將源文件拖放進工程即可。

基本使用

導入頭文件

若使用 CocoaPods 或 Carthage 安裝,可按 framework 方式導入。

若手動下載源碼安裝,則直接導入對應頭文件。

全局網絡配置

可調用 XMCenter 的 setupConfig 類方法,透過 XMConfig 設定公共網絡資訊。

可配置的項目包括 generalServer、generalParameters、generalHeaders、generalUserInfo、callbackQueue 與 consoleLog。若請求對象沒有指定 server、parameters 或 headers,且允許使用全局配置,就會自動套用 XMCenter 的公共設定。

也可隨時修改全局 header 與 parameter。

普通請求

XMRequest 支援 GET、POST、HEAD、DELETE、PUT、PATCH 等常見 HTTP 方法。

設置 URL 時,可以透過 server 與 api,也可以直接設置 url。當 server、api、url 同時存在時,url 優先級較高。

POST 請求的使用方式與 GET 類似。

上傳與下載

上傳請求可透過 XMCenter 發起,並在進度回調中取得上傳狀態。

下載請求同樣支援進度回調與完成處理。

序列化與自定義響應

XMRequest 提供 requestSerializerType 與 responseSerializerType,可設定請求參數與響應結果的序列化方式。

開發中常見需求是:請求成功後,仍需要驗證業務錯誤碼或轉換模型。此時可用 XMCenter 的 setResponseProcessBlock 注入自定義處理邏輯。若 error 被賦值,則後續會走 failure block。

批量與鏈式請求

批量請求適合多個互相獨立但業務相關的請求。只有全部成功才會執行 success,任一失敗則執行 failure。

鏈式請求適合前後依賴的場景,下一個請求是否發送取決於上一個請求結果。

取消請求與網絡檢查

發送請求後會返回 identifier,可用來取消未完成的請求。

也可查詢當前網絡可連接性。

HTTPS 與 SSL Pinning

在 App 內加入 SSL 證書校驗,有助於降低中間人攻擊風險。可透過 XMEngine 暴露的 sessionManager 調整 securityPolicy。

代碼結構

XMNetworking 的核心文件非常精簡,主要包括 XMConst.h、XMRequest、XMCenter 與 XMEngine。

待完善方向

後續可支援斷點下載、網絡層緩存、tvOS/watchOS/macOS 兼容性、更強大的模型轉換,以及可擴展插件機制。

XMNetworking 使用 MIT 許可證,適合在 iOS 專案中作為輕量網絡層使用。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved