Web Service 依賴的核心協議是 HTTP,也就是超文本傳輸協議。HTTP/1.1 一共定義了 8 種請求方法:OPTIONS、HEAD、GET、POST、PUT、DELETE、TRACE、CONNECT,作為與 Web 服務器溝通的語彙。
NSMutableURLRequest 來構造請求。iOS SDK 為 HTTP 請求提供了同步與異步兩套 API:
兩者的本質差別就在於連接方式。下面以一個登陸接口為例,把幾種情況逐一走一遍。
本次開發環境:Xcode 7.2,iOS Simulator iPhone 6。
// 1. 拼接請求路徑
NSString *webPath = [NSString stringWithFormat:@"https://172.16.2.254/php/phonelogin?name=%@&pass=%@&btn=login", yourname, yourpass];
// URL 不允許出現中文等特殊字符,需要先做轉義,例如空格會變成 %20
webPath = [webPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:webPath];
// 2. 構造請求
NSURLRequest *request = [NSURLRequest requestWithURL:url];
NSURLResponse *respone = nil; // 響應信息,可以為 nil
NSError *error = nil; // 錯誤信息,可以為 nil
// 3. 拿到服務器返回的二進制數據
NSData *data = [NSURLConnection sendSynchronousRequest:request
returningResponse:&respone
error:&error];
if (data == nil) {
NSLog(@"登陸失敗:%@,請重試", error);
return;
}
/* 4. 在這裡解析 data */
異步的關鍵是遵循 NSURLConnectionDataDelegate 協議並指定委托。
@interface ViewController : UIViewController <NSURLConnectionDataDelegate>
@property (weak, nonatomic) NSMutableData *receiveData; // 用於累積收到的數據
@end
發起請求:
NSString *webPath = [NSString stringWithFormat:@"https://172.16.2.254/php/phonelogin?name=%@&pass=%@&btn=login", yourname, yourpass];
webPath = [webPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:webPath];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
// 指定代理,以異步方式接收數據
NSURLConnection *con = [NSURLConnection connectionWithRequest:request delegate:self];
if (con == nil) {
NSLog(@"創建連接失敗");
return;
} else {
if (self.receiveData == nil) {
self.receiveData = [[NSMutableData alloc] init];
}
}
四個回調方法:
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {
NSLog(@"收到響應");
self.receiveData.length = 0; // 為當前連接重新開始累積
}
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
NSLog(@"收到數據");
[self.receiveData appendData:data];
}
- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
NSLog(@"數據接收完畢");
/* 在這裡解析 self.receiveData */
}
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {
NSLog(@"連接失敗:%@", error.localizedDescription);
}
NSString *webPath = @"https://172.16.2.254/php/phoneloginpost.php";
webPath = [webPath stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:webPath];
// POST 必須用 NSMutableURLRequest,順手指定緩存策略與超時
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url
cachePolicy:NSURLRequestUseProtocolCachePolicy
timeoutInterval:10];
// 設置提交方法,默認是 GET
[request setHTTPMethod:@"POST"];
// 參數放進 body
NSString *args = [NSString stringWithFormat:@"uname=%@&upas=%@&btn=login", uname, upas];
[request setHTTPBody:[args dataUsingEncoding:NSUTF8StringEncoding]];
NSData *recvData = [NSURLConnection sendSynchronousRequest:request
returningResponse:nil
error:nil];
if (recvData != nil) {
/* 在這裡解析 recvData */
} else {
NSLog(@"連接失敗,請重試");
}
異步 POST 與異步 GET 的區別只在於請求對象換成了 NSMutableURLRequest,並設置好 method 與 body,其餘的 NSURLConnectionDataDelegate 回調流程完全一致,這裡不再重複貼代碼。
以上就是同步/異步、GET/POST 四種組合的基本寫法。UI 控件的細節處理沒有附上,讀者可以自行補齊,組裝成一個完整的網絡請求項目。
需要提醒的是,從 iOS 9 開始 NSURLConnection 已被蘋果宣布棄用,取而代之的是 NSURLSession。新項目建議直接採用 NSURLSession 發送 GET 與 POST 請求,本文內容更适合理解早期代碼或維護老項目時參考。