每個專案都要發網絡請求,如果每頁都自己拼 NSURLRequest、自己處理回呼,程式碼很快就亂了。把「檢查網絡」與「POST 送出」抽成一個 HttpHelper 類別,之後呼叫端只要一行就能完成請求。
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import "Reachability.h"
@interface HttpHelper : NSObject
// 檢查網絡是否可用
+ (BOOL)NetWorkIsOK;
// POST 請求封裝
+ (void)post:(NSString *)Url
RequestParams:(NSDictionary *)params
FinishBlock:(void (^)(NSURLResponse *response, NSData *data, NSError *connectionError))block;
@end
// HttpHelper.m
#import "HttpHelper.h"
@implementation HttpHelper
#pragma mark - 網絡狀態檢查
// WiFi 或蜂窩數據任一可用即回傳 YES
+ (BOOL)NetWorkIsOK {
if (([[Reachability reachabilityForInternetConnection] currentReachabilityStatus] != NotReachable) &&
([[Reachability reachabilityForLocalWiFi] currentReachabilityStatus] != NotReachable)) {
return YES;
}
return NO;
}
#pragma mark - POST 異步請求
+ (void)post:(NSString *)URL RequestParams:(NSDictionary *)params FinishBlock:(void (^)(NSURLResponse *response, NSData *data, NSError *connectionError))block {
// 字串轉 URL
NSURL *url = [NSURL URLWithString:URL];
// 初始化請求,可在此調整快取策略與逾時秒數
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url
cachePolicy:NSURLRequestReloadIgnoringCacheData
timeoutInterval:20];
// 把 NSDictionary 解析成 a=1&b=2 這種 POST 字串
NSString *parseParamsResult = [self parseParams:params];
NSData *postData = [parseParamsResult dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPMethod:@"POST"];
[request setHTTPBody:postData];
// 另開一條佇列(等於開新執行緒),避免阻塞主執行緒
NSOperationQueue *queue = [NSOperationQueue new];
// 送出異步請求,完成後透過 completionHandler 回呼
[NSURLConnection sendAsynchronousRequest:request queue:queue completionHandler:block];
}
#pragma mark - 參數序列化
+ (NSString *)parseParams:(NSDictionary *)params {
NSMutableString *result = [NSMutableString new];
NSEnumerator *keyEnum = [params keyEnumerator];
id key;
while (key = [keyEnum nextObject]) {
NSString *keyValueFormat = [NSString stringWithFormat:@"%@=%@&", key, [params valueForKey:key]];
[result appendString:keyValueFormat];
}
NSLog(@"post() 方法參數解析結果:%@", result);
return result;
}
@end
- (void)login {
NSString *url = @"https://127.0.0.1/login.php";
NSString *userName = @"admin";
NSString *password = @"root";
NSMutableDictionary *params = [NSMutableDictionary new];
[params setValue:userName forKey:@"phone"];
[params setValue:password forKey:@"password"];
// 有網絡才發請求
if ([HttpHelper NetWorkIsOK]) {
[HttpHelper post:url RequestParams:params FinishBlock:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
if (data) {
// 回呼在子執行緒,更新 UI 前必須切回主執行緒
[self performSelectorOnMainThread:@selector(login_callBack:) withObject:data waitUntilDone:YES];
} else {
NSLog(@"無效的數據");
}
}];
}
}
// 登入回呼:判斷是否能登入,再決定提示或跳頁
- (void)login_callBack:(id)value {
NSLog(@"登錄成功");
}
這個版本勝在簡單明瞭,很適合當作入門範例,但正式專案還建議補上幾件事:
NSURLConnection 已被蘋果標記為 deprecated,NSURLSession 在連線管理、背景執行與取消請求上都更完善。stringByAddingPercentEncodingWithAllowedCharacters:),否則會送出錯誤的 body。另外字串拼接完記得去掉多餘的 &。data 是否為空,實際上 connectionError 與 HTTP 狀態碼都該納入判斷。dispatch_async(dispatch_get_main_queue(), ...) 或 NSURLSession 的 completionQueue 指定。