iOS开发网络篇—发送GET和POST请求（使用NSURLSession）

Posted 2020-06-10

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&参数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

　　代码执行结果：