iOS開發網路篇—傳送GET和POST請求（使用NSURLSession）
阿新 • • 發佈：2019-02-06
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
程式碼執行結果：
