在 ASIHTTPRequest 還是主流網路庫的年代,很多專案會把重複的 POST 請求流程封裝成單例類別,讓各處呼叫更簡潔。以下是一個名為 WLHTTPClient 的範例封裝。
#import <Foundation/Foundation.h>
#import "ASIFormDataRequest.h"
@protocol WLHTTPClientDelegate <NSObject>
@optional
@end
@interface WLHTTPClient : NSObject
@property (nonatomic, assign) id <WLHTTPClientDelegate> delegate;
+ (WLHTTPClient *)sharedClient;
- (void)postInfoWithDelegate:(id <WLHTTPClientDelegate>)delegate
withMethod:(NSString *)method
withParams:(NSDictionary *)params
withSuccuessMethod:(SEL)successMethod
withFailedMethod:(SEL)failMethod;
@end
#import "WLHTTPClient.h"
// 用來抑制 performSelector 可能帶來的編譯警告
#define SuppressPerformSelectorLeakWarning(Stuff) \
do { \
_Pragma(clang diagnostic push) \
_Pragma(clang diagnostic ignored "-Warc-performSelector-leaks") \
Stuff; \
_Pragma(clang diagnostic pop) \
} while (0)
@implementation WLHTTPClient
+ (WLHTTPClient *)sharedClient
{
static WLHTTPClient *_sharedClient = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_sharedClient = [[WLHTTPClient alloc] init];
});
return _sharedClient;
}
- (void)postInfoWithDelegate:(id <WLHTTPClientDelegate>)delegate
withMethod:(NSString *)method
withParams:(NSDictionary *)params
withSuccuessMethod:(SEL)successMethod
withFailedMethod:(SEL)failMethod
{
NSString *urlStr = [NSString stringWithFormat:@"%@%@", baseHttpUrl, method];
ASIFormDataRequest *request =
[ASIFormDataRequest requestWithURL:[NSURL URLWithString:urlStr]];
[request setRequestMethod:@"POST"];
// 逐一塞入 POST 參數
for (int i = 0; i < [params allKeys].count; i++) {
[request addPostValue:params[[params allKeys][i]]
forKey:[params allKeys][i]];
}
[request setCompletionBlock:^{
NSData *jsonData = request.responseData;
id result = [NSJSONSerialization JSONObjectWithData:jsonData
options:NSJSONReadingMutableContainers
error:nil];
SuppressPerformSelectorLeakWarning(
[delegate performSelector:successMethod withObject:result];
);
}];
[request setFailedBlock:^{
SuppressPerformSelectorLeakWarning(
[delegate performSelector:failMethod
withObject:@"網絡連接失敗,請檢查您的網絡連接或重試!"];
);
}];
[request startAsynchronous];
}
@end
單例模式:透過 dispatch_once 保證 WLHTTPClient 在整個 App 生命週期內只建立一次,全域共用同一個網路客戶端。
參數化回呼:呼叫端只需傳入 method、params 以及成功/失敗時要觸發的 SEL,封裝內部即負責組裝請求、解析 JSON 並透過 delegate 回傳結果,大幅降低各畫面的重複程式碼。
警告抑制:由於使用 performSelector 動態呼叫方法,編譯器無法靜態檢查 selector 是否存在,因此以巨集暫時關閉 -Warc-performSelector-leaks 警告,讓程式碼更乾淨。