做專案時,只要把網路請求封裝好,之後無論場景多複雜,呼叫起來都會非常輕鬆。本文以 AFNetworking 為基礎,示範如何打造一個通用的 DataRequestManager 來統一管理各類請求。
首先,把常用的 AFNetworking 引入專案的 pch 頭檔中(建議用 CocoaPods 安裝,相關介紹可參考部落格其他文章)。接著開始實作。
這個類別專門負責管理所有網路請求,以下程式碼可直接複製使用。
// 透過代理把資料傳回需要的地方
@protocol DataRequestManagerDelegate <NSObject>
- (void)passValue:(id)value;
@optional
- (void)passGetValue:(id)getValue;
@end
@interface DataRequestManager : NSObject
{
AFHTTPRequestOperationManager *manager; // 建立請求(iOS 6-7)
AFURLSessionManager *sessionManager; // 建立請求(iOS 7 專用)
AFHTTPRequestOperation *operation; // 請求管理(用於上傳與下載)
}
@property (nonatomic, assign) id<DataRequestManagerDelegate> delegate;
// GET 請求
- (void)methodGetWithURL:(NSString *)urlString;
// POST 請求
- (void)methodPostWithURL:(NSString *)urlString parameters:(NSDictionary *)parameters;
// 上傳圖片
- (void)methodUploadWithURL:(NSString *)urlString parameters:(NSDictionary *)parameters image:(UIImage *)image;
@end
以下重點說明各方法的實作。
// GET 請求:先將 manager 致空再重建,發送請求後透過代理回傳結果。
- (void)methodGetWithURL:(NSString *)urlString
{
if (manager) { manager = nil; }
manager = [AFHTTPRequestOperationManager manager];
// 預設解析器為 AFJSONResponseSerializer(解析 JSON)
[manager GET:urlString parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
[self.delegate passGetValue:responseObject];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"Error: %@", error);
}];
}
// POST 請求:架構與 GET 類似,差在多了 parameters 參數。
- (void)methodPostWithURL:(NSString *)urlString parameters:(NSDictionary *)parameters
{
if (manager) { manager = nil; }
manager = [AFHTTPRequestOperationManager manager];
[manager POST:urlString parameters:parameters success:^(AFHTTPRequestOperation *operation, id responseObject) {
[self.delegate passValue:responseObject];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"Error: %@", error);
}];
}
// 上傳(以表單方式,圖片為例):使用 constructingBodyWithBlock 加入檔案。
- (void)methodUploadWithURL:(NSString *)urlString parameters:(NSDictionary *)parameters image:(UIImage *)image
{
if (manager) { manager = nil; }
manager = [AFHTTPRequestOperationManager manager];
[manager POST:urlString parameters:parameters constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {
NSData *imageData = UIImageJPEGRepresentation(image, 1.0);
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
formatter.dateFormat = @"yyyyMMddHHmmss";
NSString *fileName = [[formatter stringFromDate:[NSDate date]] stringByAppendingString:@".png"];
[formData appendPartWithFileData:imageData name:@"uploadFile" fileName:fileName mimeType:@"image/jpeg"];
} success:^(AFHTTPRequestOperation *operation, id responseObject) {
[self.delegate passValue:responseObject];
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
NSLog(@"Error: %@", error);
}];
}
透過 AFHTTPRequestOperation 搭配 outputStream 與 downloadProgressBlock,即可實作下載進度與存檔。而斷點續傳的關鍵在於對 operation 呼叫 start / pause / resume:
// 開始下載
- (void)downloadStart { [self methodDownload]; [operation start]; }
// 暫停下載
- (void)downloadPause { [operation pause]; }
// 繼續下載
- (void)downloadResume { [operation resume]; }
在 iOS 7 上,可改用 AFURLSessionManager 搭配 NSURLSessionUploadTask 與 NSURLSessionDownloadTask 來處理上傳與下載。下載時透過 destination block 指定存檔位置(例如沙盒的 Documents 目錄),再呼叫 resume 啟動任務即可。
整體而言,把這些請求邏輯集中封裝在一個 Manager 裡,之後各頁面只需透過代理接收結果,維護起來乾淨又省心。以上程式碼可直接複製使用。