iOS開發網絡篇—發送GET和POST請求（使用NSURLSession）

時間 2019-11-10

標籤 ios 開發網絡發送 post 請求使用 nsurlsession 欄目 iOS 简体版

原文原文鏈接

iOS開發網絡篇—發送GET和POST請求（使用NSURLSession）html

說明：git

　　1）該文主要介紹如何使用NSURLSession來發送GET請求和POST請求github

　　2）本文將再也不講解NSURLConnection的使用，若有須要瞭解NSURLConnection如何發送請求。服務器

　　　　詳細信息，請參考：http://www.cnblogs.com/wendingding/p/3813706.html網絡

　　3）本文示例代碼發送的請求均爲http請求，已經對info.plist文件進行配置。session

　　　　如何配置，請參考：https://github.com/HanGangAndHanMeimei/iOS9AdaptationTipsapp

　　4）本文示例代碼，能夠在下面的地址獲取：ide

　　　　https://github.com/HanGangAndHanMeimei/Codepost

1、簡單說明編碼

　　在iOS9.0以後，之前使用的NSURLConnection過時，蘋果推薦使用NSURLSession來替換NSURLConnection完成網路請求相關操做。

　　NSURLSession的使用很是簡單，先根據會話對象建立一個請求Task，而後執行該Task便可。

　　NSURLSessionTask自己是一個抽象類，在使用的時候，一般是根據具體的需求使用它的幾個子類。關係以下：

2、發送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&參數3
 6     //協議頭(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 }

發送GET請求的第一種方法

 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 }

發送GET請求的第二種方法

　　執行結果：

　　此處打印的值是一個字典，字典中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

字典分類中重寫系統方法

　　執行結果：

3、發送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 }

發送POST請求的方法

4、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