MKNetworkKit 是一個以 Objective-C 編寫的網絡框架,原生支援 Block 與 ARC,用法簡潔。它融會了 ASIHTTPRequest 與 AFNetworking 兩個框架的優秀特性,並在此基礎上新增了許多實用功能,讓開發者得以擺脫繁瑣的網絡程式碼。
整個框架僅由 2 個類及若干類別方法構成,使用極為簡單,全程式只有一個全域隊列。
對於高度依賴網路的 App 而言,控制網絡線程的並發數至關重要,但多數框架在這方面做得並不理想。以 3G 網絡為例,絕大多數行動網絡對同一 IP 的 HTTP 並發連接數限制在 2 個以內,Edge 甚至常常不足 1 個,而家用寬帶(Wi-Fi)則寬鬆得多(約 6 個)。若未能妥善控制上傳隊列中的線程數,當你在某個視圖中嘗試加載縮圖時,上傳線程被擠到後台,就可能導致縮圖加載超時。
正確做法是讓整個程式只擁有一個 queue 隊列。MKNetworkKit 透過在每個實例中使用單例來保證這一點——並非 MKNetworkKit 本身是單例,而是它的共享隊列是單例。
目前主流網絡框架包括 AFNetworking、ASIHTTPRequest、SDWebImage、MKNetworkKit 等,而 MKNetworkKit 正是汲取了前兩者的優點並融入自身特色。
GitHub 位址:https://github.com/MugunthKumar/MKNetworkKit.git
官方使用說明:https://blog.mugunthkumar.com/products/ios-framework-introducing-mknetworkkit/
注意:從 GitHub 下載後若想運行其 demo,務必打開 MKNetworkKit.xcworkspace 檔案,否則編譯時會提示缺少 libMKNetworkKit-iOS.a 檔案。
安裝步驟:克隆後將 MKNetworkKit 文件夾拖入專案,並引入 3 個 framework:

由於 MKNetworkKit 支援 ARC,專案必須開啟 ARC,否則會報錯:

開啟 ARC 後,專案中所有的 dealloc、release、autorelease 都需註釋掉:

在需要處導入:#import "MKNetworkKit.h"
許多第三方框架透過「網絡連接數增加/減少」的回調來顯示網絡狀態,而 MKNetworkKit 由於採用單例共享隊列,能自動處理。共享隊列中有一個線程透過 KVO 隨時觀察 operationCount 屬性,開發者通常無需操心。
if (object == _sharedNetworkQueue && [keyPath isEqualToString:@"operationCount"]) {
[UIApplication sharedApplication].networkActivityIndicatorVisible = ([_sharedNetworkQueue.operations count] > 0);
}
絕大多數行動網絡不允許 2 個以上並發連接,因此隊列大小在 3G 網絡下應設為 2。MKNetworkKit 會自動處理:當網絡處於 3G/EDGE/GPRS 時調整為 2,處於 Wi-Fi 時則調整為 6。這在透過 3G 加載縮圖時尤為受用。
MKNetworkKit 能自動緩存所有 GET 請求。當你再次發起相同請求時,它會立即用 response 緩存調用 handler 處理,同時也向伺服器發出請求,一旦取得新數據便再次調用 handler。你無需手動緩存,只需開啟:
[[MKNetworkEngine sharedEngine] useCache];
你也可以透過子類化覆蓋此方法,自訂緩存路徑與佔用的記憶體開銷。
MKNetworkKit 能「凍結」網絡操作。當操作被標記為可凍結時,一旦網絡斷開,它們會自動序列化,並在設備重新連線時自動提交一次,類似 Twitter 客戶端的「草稿」機制。整個過程無需撰寫任何程式碼,可用於收藏推文、分享連結到 Instapaper 等場景。
MKNetworkKit 內建縮圖緩存,只需覆蓋少數方法即可設定記憶體中最大緩存圖片數量與緩存目錄。其緩存機制類似 NSCache,當偵測到記憶體警告時,會將記憶體中的數據寫入緩存目錄。
MKNetworkKit 完全支援 ARC,而 ARC 通常比非 ARC 程式碼更快。對於新專案而言,這是相當實用的特性。
MKNetworkKit 主要由兩個核心類構成:
MKNetworkOperation:好比 ASIHTTPRequest 類,是 NSOperation 的子類,封裝了 request 與 response。每個網絡操作都需創建一個 MKNetworkOperation。
MKNetworkEngine:一個偽單例類,管理程式中的網絡隊列。它為偽單例,意味著對簡單請求可直接使用其方法;若要深度定製則應子類化。每個子類擁有自己的 Reachability 物件,用於接收伺服器可達性通知。對於不同的 REST 伺服器,可考慮建立獨立的子類。
步驟一,建立繼承自 MKNetworkEngine 的 YahooEngine,以主機名和自訂標頭初始化:
NSMutableDictionary *headerFields = [NSMutableDictionary dictionary];
[headerFields setValue:@"iOS" forKey:@"x-client-identifier"];
self.engine = [[YahooEngine alloc] initWithHostName:@"download.finance.yahoo.com" customHeaderFields:headerFields];
步驟二,關注分離設計。引擎方法不應將 URL 或 HTTP 標頭暴露給調用者,視圖只需傳入貨幣種類即可。父類中定義了三種 Block 型別:
typedef void (^ProgressBlock)(double progress);
typedef void (^ResponseBlock)(MKNetworkOperation* operation);
typedef void (^ErrorBlock)(NSError* error);
步驟三,在 Engine 中完成資料轉換,將 JSON/XML 轉為模型物件,視圖控制器不應知曉任何 JSON 節點的 key。
步驟四,實現方法。獲取匯率最簡單的方式是發起 GET 請求:
#define YAHOO_URL(__C1__, __C2__) [NSString stringWithFormat:@"d/quotes.csv?e=.csv&f=sl1d1t1&s=%@%@=X", __C1__, __C2__]
MKNetworkOperation *op = [self operationWithPath:YAHOO_URL(sourceCurrency, targetCurrency)
params:nil
httpMethod:@"GET"];
[op onCompletion:^(MKNetworkOperation *completedOperation) {
DLog(@"%@", [completedOperation responseString]);
// 在此處理資料並轉為模型
completionBlock(5.0f);
} onError:^(NSError* error) {
errorBlock(error);
];
[self enqueueOperation:op];
return op;
此段程式碼格式化 URL、創建 MKNetworkOperation,設置 completion 與 error 區塊後加入隊列並回傳引用。若在 viewDidAppear 中調用此方法,即可在 viewWillDisappear 中取消 operation,从而提升 App 效能。
要上傳圖片,可透過 MKNetworkOperation 的 addFile:forKey: 方法將檔案作為 multi-part 表單數據提交;若要上傳 NSData 形式的圖片(如相機直接拍攝),則使用 addData:forKey: 方法。
只需設置 MKNetworkOperation 的 outputStream 即可:
[operation setDownloadStream:[NSOutputStream outputStreamToFileAtPath:@"/Users/mugunth/Desktop/DownloadedFile.pdf" append:YES]];
對於下載圖片,可提供絕對 URL 而非路徑,使用 MKNetworkEngine 的 operationWithURLString:params:httpMethod: 方法創建線程。MKNetworkEngine 相當聰明,會將同一 URL 的多個 GET 請求合併為一個,完成後通知所有區塊,顯著提升縮圖渲染速度。
MKNetworkOperation 公開了多種取得響應數據的方法:responseData、responseString、responseJSON(僅 iOS 5)、responseImage、responseXML、error。若格式不符,方法會回傳 nil,只有 responseData 能保證任何格式都正確返回。
關於 GCD 的說明:由於網絡線程可能需要被停止或調整優先級,作者放棄了 GCD。雖然 GCD 效率較 NSOperation 更高,但無法做到這一點,因此建議網絡線程中也不要使用基於 GCD 的隊列。