每個專案都要發 POST 請求、解析 JSON、再回呼到 delegate,重複寫上幾十次很膩。以下把這些樣板收攏成一個單例化的 HTTP 客戶端。
#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"
#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];
__weak ASIFormDataRequest *request =
[ASIFormDataRequest requestWithURL:[NSURL URLWithString:urlStr]];
[request setRequestMethod:@"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
1. 單例化:用 dispatch_once 保證全域只有一個客戶端實例。
2. 組 URL:把 baseHttpUrl 與 method 拼接,呼叫端只需傳相對路徑。
3. 轉 POST 參數:遍歷 params 逐筆塞進表單。
4. 自動解析 JSON:完成後直接回傳已解析的物件,呼叫端不必再處理 NSData。
5. 回呼方法由 SEL 指定:成功與失敗的處理方法名稱由呼叫方決定,彈性最大。
這份程式碼寫於 ASIHTTPRequest 的年代,如今有幾處必須調整才能用於正式專案:
第一,ASIHTTPRequest 早已停止維護,也不支援 ATS(App Transport Security),新專案請改用 AFNetworking 或原生 NSURLSession。
第二,回呼方式建議改用 block。用 SEL 加 performSelector 雖然彈性高,但方法名寫錯要到執行期才發現,而且 SuppressPerformSelectorLeakWarning 這個巨集本質上是在壓警告而非解決問題。改用 block 可以獲得編譯期檢查與型別提示。
第三,delegate 用 assign 修飾在 ARC 下存在懸垂指標風險,應改為 weak。
第四,成功與失敗的回呼若跨線程,記得包一層 dispatch_async 回主線程,否則更新 UI 會靜默失效或直接崩潰。