且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

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

更新时间:2022-06-20 02:10:03

说明:

  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本身是一个抽象类,在使用的时候,通常是根据具体的需求使用它的几个子类。关系如下:

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

二、发送GET请求

  使用NSURLSession发送GET请求的方法和NSURLConnection类似,整个过程如下:

    1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供),GET请求参数直接跟在URL后面

    2)创建请求对象(默认包含了请求头和请求方法【GET】),此步骤可以省略

    3)创建会话对象(NSURLSession)

    4)根据会话对象创建请求任务(NSURLSessionDataTask)

    5)执行Task

    6)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)

  示例代码:

iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)
 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 }
iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)
 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 }
iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

  执行结果:

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

  此处打印的值是一个字典,字典中success这个key对应的value打印出来为Unicode编码的,如果想输出中文,可以为NSDictionary提供一个分类,重写系统中的方法。

iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)
 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
iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

  执行结果:

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

三、发送POST请求

  使用NSURLSession发送POST请求的方法和NSURLConnection类似,整个过程如下:

    1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供)

    2)创建可变的请求对象(因为需要修改),此步骤不可以省略

    3)修改请求方法为POST

    4)设置请求体,把参数转换为二进制数据并设置请求体

    5)创建会话对象(NSURLSession)

    6)根据会话对象创建请求任务(NSURLSessionDataTask)

    7)执行Task

    8)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)

  示例代码:

iOS开发网络篇—发送GET和POST请求(使用NSURLSession)iOS开发网络篇—发送GET和POST请求(使用NSURLSession)
 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 }
iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

四、NSURLSession代理方法简单介绍

  有的时候,我们可能需要监听网络请求的过程(如下载文件需监听文件下载进度),那么就需要用到代理方法。

  接下来通过代码简单说明NSURLSession中普通网络请求会涉及代理方法的使用

iOS开发网络篇—发送GET和POST请求(使用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
iOS开发网络篇—发送GET和POST请求(使用NSURLSession)

  代码执行结果:

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