在 Objective-C 的網路編程裡,NSMutableURLRequest 搭配 NSURLConnection 是最經典的一組組合。很多初學者會困惑:同一個 request 物件,怎麼有「同步」和「非同步」兩種截然不同的寫法?本文用一個抓取國家電話代碼的實際範例,把兩種做法並排說明。
sendSynchronousRequest:returningResponse:error: 會讓呼叫它的執行緒一直等下去,直到伺服器回應或逾時為止。因此它絕對不能直接寫在主執行緒上,否則整個 UI 會凍住、無法回應任何操作。正確做法是用 GCD 把整段請求包進背景佇列的 block 裡。
#pragma mark - 取得國家代碼(同步)
- (void)getCountryCodeSync {
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
NSString *urlString = @"https://www.baidu.com";
NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init];
[request setURL:[NSURL URLWithString:urlString]];
[request setHTTPMethod:@"POST"];
[request setValue:@"application/x-www-form-urlencoded"
forHTTPHeaderField:@"Content-Type"];
[request setValue:@"ios"
forHTTPHeaderField:@"X-Channel"];
[request setValue:@"1000"
forHTTPHeaderField:@"X-APP-ID"];
NSHTTPURLResponse *urlResponse = nil;
NSError *error = nil;
NSData *responseData =
[NSURLConnection sendSynchronousRequest:request
returningResponse:&urlResponse
error:&error];
if ([urlResponse statusCode] >= 200 && [urlResponse statusCode] < 300) {
NSDictionary *countryDic =
[NSJSONSerialization JSONObjectWithData:responseData
options:NSJSONReadingMutableLeaves
error:&error];
NSArray *countryArr = [[countryDic objectForKey:@"data"]
objectForKey:@"phone_codes"];
if (countryArr) {
for (int i = 0; i < [countryArr count]; i++) {
NSDictionary *item = [countryArr objectAtIndex:i];
NSLog(@"countryCode: %@ %@",
[item objectForKey:@"country"],
[item objectForKey:@"code"]);
}
}
} else {
NSLog(@"HTTP 狀態碼異常:%ld", (long)[urlResponse statusCode]);
}
});
}
這裡有兩個細節值得注意:一是 statusCode 回傳的是基本型別,取值時要轉型成 long 再印,避免 64 位元環境下的警告;二是 JSON 解析最好放在狀態碼判斷成功之後再做,否則拿到錯誤頁面也會硬去解析。
非同步版本不需要自己開佇列,只要把 request 交給 NSURLConnection 的 delegate 初始化器,系統會在背景下載,並透過一連串 delegate 方法把結果分段送回來。
#pragma mark - 取得國家代碼(非同步)
- (void)getCountryCodeAsync {
NSString *urlString = @"https://www.baidu.com";
NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init];
[request setURL:[NSURL URLWithString:urlString]];
[request setCachePolicy:NSURLRequestUseProtocolCachePolicy]; // 快取策略
[request setTimeoutInterval:20.0]; // 逾時秒數
[request setHTTPMethod:@"POST"];
NSURLConnection *connection =
[[NSURLConnection alloc] initWithRequest:request delegate:self];
if (connection == nil) {
NSLog(@"連線建立失敗");
return;
}
}
// 收到回應標頭
- (void)connection:(NSURLConnection *)connection
didReceiveResponse:(NSURLResponse *)response {
NSLog(@"收到回應");
}
// 分次接收資料
- (void)connection:(NSURLConnection *)connection
didReceiveData:(NSData *)data {
NSError *error = nil;
NSDictionary *countryDic =
[NSJSONSerialization JSONObjectWithData:data
options:NSJSONReadingMutableLeaves
error:&error];
NSArray *countryArr = [[countryDic objectForKey:@"data"]
objectForKey:@"phone_codes"];
if (countryArr) {
for (int i = 0; i < [countryArr count]; i++) {
NSDictionary *item = [countryArr objectAtIndex:i];
NSLog(@"countryCode: %@ %@",
[item objectForKey:@"country"],
[item objectForKey:@"code"]);
}
}
}
// 全部下載完成
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
NSLog(@"finishLoading");
}
// 發生錯誤
- (void)connection:(NSURLConnection *)connection
didFailWithError:(NSError *)error {
NSLog(@"連線失敗:%@", error);
}
另外要提醒的是,這份範例屬於較早期的寫法。NSURLConnection 從 iOS 7 起就被標記為不建議使用,目前主流做法是改用 NSURLSession,它能用 block 或 delegate 兩種風格撰寫,並原生支援背景傳輸。若只是臨時測試,NSURLSession dataTaskWithRequest:completionHandler: 一行就能取代上面數十行 delegate 程式碼。理解 NSURLConnection 的運作原理仍有價值,因為 NSURLSession 的 delegate 模型與它一脉相承。