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本身是一個抽象類,在使用的時候,通常是根據具體的需求使用它的幾個子類。關系如下:
![](https://img.laitimes.com/img/_0nNw4CM6IyYiwiM6ICdiwiIn5GcuIzYiFDOhNDNwQ2YjNTMmFWM3EDZiZTN0QGOygDNhFWMfdWbp9CXt92Yu4GZjlGbh5SZslmZxl3Lc9CX6MHc0RHaiojIsJye.png)
二、發送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
字典分類中重寫系統方法
三、發送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請求的方法
四、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
代碼執行結果: