本文示範兩種最基礎的 HTTP 請求寫法:同步 GET 與非同步下載。兩者的差別不只是「會不會卡住」,更決定了你的 App 使用者體驗是順滑還是凍結。
// 組出請求字串
NSString *urlStr = [NSString stringWithFormat:@"https://www.baidu.com/s?wd=%@", @"php"];
// 字串轉為 NSURL
NSURL *url = [NSURL URLWithString:urlStr];
// URL 轉為 request
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 回應物件(會帶回狀態碼、標頭等)
NSURLResponse *response;
// 同步發送,會在這一行卡住直到回應到齊
NSData *resultData = [NSURLConnection sendSynchronousRequest:request
returningResponse:&response
error:nil];
// 把回應資料轉成字串
NSString *dataString = [[NSString alloc] initWithData:resultData encoding:NSUTF8StringEncoding];
NSLog(@"%@", dataString);
// 後續就可以拿去解析 JSON
若需要自訂方法、逾時或標頭,改用 NSMutableURLRequest:
NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init]; [request setURL:url]; [request setHTTPMethod:@"POST"]; [request setTimeoutInterval:60]; [request setHTTPBody:_data]; [request setValue:@"ttt" forHTTPHeaderField:@"cookies"];
為什麼不該在正式產品中這樣寫?
同步請求只適合用在「確實必須、且已在背景佇列」的少數場景,例如啟動時讀取本地設定檔。網路 IO 請一律走非同步。
- (void)viewDidLoad {
[super viewDidLoad];
_data = [[NSMutableData alloc] init];
NSString *urlStr = [NSString stringWithFormat:@"https://www.baidu.com/s?wd=%@", @"php"];
NSURL *url = [NSURL URLWithString:urlStr];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 發起請求並指定代理,方法立即返回,不阻塞
[NSURLConnection connectionWithRequest:request delegate:self];
}
// 資料分批送達,可能呼叫多次
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
[_data appendData:data];
NSLog(@"%@", _data);
}
// 全部資料到齊
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
NSString *dataString = [[NSString alloc] initWithData:_data encoding:NSUTF8StringEncoding];
NSLog(@"%@", dataString);
}
三個設計要點:
connection:didFailWithError:,但正式程式必須處理它,否則網路異常時使用者只會看到永久的 loading。NSURLConnection 從 iOS 9 起已被蘋果標記為正式廢棄。新專案請直接改用下列任一方案:
用 NSURLSession 改寫上面的非同步範例,大致長這樣:
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithURL:url
completionHandler:^(NSData *data,
NSURLResponse *response,
NSError *error) {
if (error) {
NSLog(@"請求失敗:%@", error);
return;
}
NSString *dataString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
// completionHandler 在背景佇列,更新 UI 必須切回主執行緒
dispatch_async(dispatch_get_main_queue(), ^{
NSLog(@"%@", dataString);
});
}];
[task resume]; // 記得 resume,dataTask 建立後是暫停狀態
最後提醒兩點:URL 中含中文或空白時,務必先做 stringByAddingPercentEncodingWithAllowedCharacters: 編碼,否則 request 會建立失敗;另外自 iOS 9 起 App Transport Security 預設阻擋明文 HTTP,測試用的 http 端點需要在 Info.plist 中例外處理,正式環境則應全面改用 HTTPS。