iOS開發網路篇—傳送GET和POST請求(使用NSURLSession)
1)該文主要介紹如何使用NSURLSession來發送GET請求和POST請求
2)本文將不再講解NSURLConnection的使用,如有需要了解NSURLConnection如何傳送請求。
詳細資訊,請參考:http://www.cnblogs.com/wendingding/p/3813706.html
3)本文示例程式碼傳送的請求均為http請求,已經對info.plist檔案進行配置。
如何配置,請參考:https://github.com/HanGangAndHanMeimei/iOS9AdaptationTips
4)本文示例程式碼,可以在下面的地址獲取:
https://github.com/HanGangAndHanMeimei/Code
一、簡單說明
在iOS9.0之後,以前使用的NSURLConnection過期,蘋果推薦使用NSURLSession來替換NSURLConnection完成網路請求相關操作。
NSURLSession的使用非常簡單,先根據會話物件建立一個請求Task,然後執行該Task即可。
NSURLSessionTask本身是一個抽象類,在使用的時候,通常是根據具體的需求使用它的幾個子類。關係如下:
二、傳送GET請求
使用NSURLSession傳送GET請求的方法和NSURLConnection類似,整個過程如下:
1)確定請求路徑(一般由公司的後臺開發人員以介面文件的方式提供),GET請求引數直接跟在URL後面
2)建立請求物件(預設包含了請求頭和請求方法【GET】),此步驟可以省略
3)建立會話物件(NSURLSession)
4)根據會話物件建立請求任務(NSURLSessionDataTask)
5)執行Task
6)當得到伺服器返回的響應後,解析資料(XML|JSON|HTTP)
示例程式碼:
1 -(void)get1 2 { 3 //對請求路徑的說明 4 //http://120.25.226.186:32812/login?username=520it&pwd=520&type=JSON 5 //協議頭+主機地址+介面名稱+?+引數1&引數2&引數36 //協議頭(http://)+主機地址(120.25.226.186:32812)+介面名稱(login)+?+引數1(username=520it)&引數2(pwd=520)&引數3(type=JSON) 7 //GET請求,直接把請求引數跟在URL的後面以?隔開,多個引數之間以&符號拼接 8 9 //1.確定請求路徑 10 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; 11 12 //2.建立請求物件 13 //請求物件內部預設已經包含了請求頭和請求方法(GET) 14 NSURLRequest *request = [NSURLRequest requestWithURL:url]; 15 16 //3.獲得會話物件 17 NSURLSession *session = [NSURLSession sharedSession]; 18 19 //4.根據會話物件建立一個Task(傳送請求) 20 /* 21 第一個引數:請求物件 22 第二個引數:completionHandler回撥(請求完成【成功|失敗】的回撥) 23 data:響應體資訊(期望的資料) 24 response:響應頭資訊,主要是對伺服器端的描述 25 error:錯誤資訊,如果請求失敗,則error有值 26 */ 27 NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { 28 29 if (error == nil) { 30 //6.解析伺服器返回的資料 31 //說明:(此處返回的資料是JSON格式的,因此使用NSJSONSerialization進行反序列化處理) 32 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; 33 34 NSLog(@"%@",dict); 35 } 36 }]; 37 38 //5.執行任務 39 [dataTask resume]; 40 }
1 -(void)get2 2 { 3 //1.確定請求路徑 4 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; 5 6 //2.獲得會話物件 7 NSURLSession *session = [NSURLSession sharedSession]; 8 9 //3.根據會話物件建立一個Task(傳送請求) 10 /* 11 第一個引數:請求路徑 12 第二個引數:completionHandler回撥(請求完成【成功|失敗】的回撥) 13 data:響應體資訊(期望的資料) 14 response:響應頭資訊,主要是對伺服器端的描述 15 error:錯誤資訊,如果請求失敗,則error有值 16 注意: 17 1)該方法內部會自動將請求路徑包裝成一個請求物件,該請求物件預設包含了請求頭資訊和請求方法(GET) 18 2)如果要傳送的是POST請求,則不能使用該方法 19 */ 20 NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { 21 22 //5.解析資料 23 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; 24 NSLog(@"%@",dict); 25 26 }]; 27 28 //4.執行任務 29 [dataTask resume]; 30 }
執行結果:
此處列印的值是一個字典,字典中success這個key對應的value打印出來為Unicode編碼的,如果想輸出中文,可以為NSDictionary提供一個分類,重寫系統中的方法。
1 #import "NSDictionary+Log.h" 2 3 @implementation NSDictionary (Log) 4 5 -(NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level 6 { 7 //初始化可變字串 8 NSMutableString *string = [NSMutableString string]; 9 //拼接開頭[ 10 [string appendString:@"["]; 11 12 //拼接字典中所有的鍵值對 13 [self enumerateKeysAndObjectsUsingBlock:^(id _Nonnull key, id _Nonnull obj, BOOL * _Nonnull stop) { 14 [string appendFormat:@"%@:",key]; 15 [string appendFormat:@"%@",obj]; 16 }]; 17 18 //拼接結尾] 19 [string appendString:@"]"]; 20 21 return string; 22 } 23 24 @end
執行結果:
三、傳送POST請求
使用NSURLSession傳送POST請求的方法和NSURLConnection類似,整個過程如下:
1)確定請求路徑(一般由公司的後臺開發人員以介面文件的方式提供)
2)建立可變的請求物件(因為需要修改),此步驟不可以省略
3)修改請求方法為POST
4)設定請求體,把引數轉換為二進位制資料並設定請求體
5)建立會話物件(NSURLSession)
6)根據會話物件建立請求任務(NSURLSessionDataTask)
7)執行Task
8)當得到伺服器返回的響應後,解析資料(XML|JSON|HTTP)
示例程式碼:
1 -(void)post 2 { 3 //對請求路徑的說明 4 //http://120.25.226.186:32812/login 5 //協議頭+主機地址+介面名稱 6 //協議頭(http://)+主機地址(120.25.226.186:32812)+介面名稱(login) 7 //POST請求需要修改請求方法為POST,並把引數轉換為二進位制資料設定為請求體 8 9 //1.建立會話物件 10 NSURLSession *session = [NSURLSession sharedSession]; 11 12 //2.根據會話物件建立task 13 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"]; 14 15 //3.建立可變的請求物件 16 NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url]; 17 18 //4.修改請求方法為POST 19 request.HTTPMethod = @"POST"; 20 21 //5.設定請求體 22 request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding]; 23 24 //6.根據會話物件建立一個Task(傳送請求) 25 /* 26 第一個引數:請求物件 27 第二個引數:completionHandler回撥(請求完成【成功|失敗】的回撥) 28 data:響應體資訊(期望的資料) 29 response:響應頭資訊,主要是對伺服器端的描述 30 error:錯誤資訊,如果請求失敗,則error有值 31 */ 32 NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { 33 34 //8.解析資料 35 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; 36 NSLog(@"%@",dict); 37 38 }]; 39 40 //7.執行任務 41 [dataTask resume]; 42 }
四、NSURLSession代理方法簡單介紹
有的時候,我們可能需要監聽網路請求的過程(如下載檔案需監聽檔案下載進度),那麼就需要用到代理方法。
接下來通過程式碼簡單說明NSURLSession中普通網路請求會涉及代理方法的使用
1 #import "ViewController.h" 2 3 @interface ViewController ()<NSURLSessionDataDelegate> 4 @property (nonatomic, strong) NSMutableData *responseData; 5 @end 6 7 @implementation ViewController 8 9 -(NSMutableData *)responseData 10 { 11 if (_responseData == nil) { 12 _responseData = [NSMutableData data]; 13 } 14 return _responseData; 15 } 16 17 //當點選控制器View的時候會呼叫該方法 18 -(void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event 19 { 20 [self delegateTest]; 21 } 22 23 //傳送請求,代理方法 24 -(void)delegateTest 25 { 26 //1.確定請求路徑 27 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; 28 29 //2.建立請求物件 30 //請求物件內部預設已經包含了請求頭和請求方法(GET) 31 NSURLRequest *request = [NSURLRequest requestWithURL:url]; 32 33 //3.獲得會話物件,並設定代理 34 /* 35 第一個引數:會話物件的配置資訊defaultSessionConfiguration 表示預設配置 36 第二個引數:誰成為代理,此處為控制器本身即self 37 第三個引數:佇列,該佇列決定代理方法在哪個執行緒中呼叫,可以傳主佇列|非主佇列 38 [NSOperationQueue mainQueue] 主佇列: 代理方法在主執行緒中呼叫 39 [[NSOperationQueue alloc]init] 非主佇列: 代理方法在子執行緒中呼叫 40 */ 41 NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]]; 42 43 //4.根據會話物件建立一個Task(傳送請求) 44 NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request]; 45 46 //5.執行任務 47 [dataTask resume]; 48 } 49 50 //1.接收到伺服器響應的時候呼叫該方法 51 -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler 52 { 53 //在該方法中可以得到響應頭資訊,即response 54 NSLog(@"didReceiveResponse--%@",[NSThread currentThread]); 55 56 //注意:需要使用completionHandler回撥告訴系統應該如何處理伺服器返回的資料 57 //預設是取消的 58 /* 59 NSURLSessionResponseCancel = 0, 預設的處理方式,取消 60 NSURLSessionResponseAllow = 1, 接收伺服器返回的資料 61 NSURLSessionResponseBecomeDownload = 2,變成一個下載請求 62 NSURLSessionResponseBecomeStream 變成一個流 63 */ 64 65 completionHandler(NSURLSessionResponseAllow); 66 } 67 68 //2.接收到伺服器返回資料的時候會呼叫該方法,如果資料較大那麼該方法可能會呼叫多次 69 -(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data 70 { 71 NSLog(@"didReceiveData--%@",[NSThread currentThread]); 72 73 //拼接伺服器返回的資料 74 [self.responseData appendData:data]; 75 } 76 77 //3.當請求完成(成功|失敗)的時候會呼叫該方法,如果請求失敗,則error有值 78 -(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error 79 { 80 NSLog(@"didCompleteWithError--%@",[NSThread currentThread]); 81 82 if(error == nil) 83 { 84 //解析資料,JSON解析請參考http://www.cnblogs.com/wendingding/p/3815303.html 85 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil]; 86 NSLog(@"%@",dict); 87 } 88 } 89 @end
程式碼執行結果: