iOS开发网络篇—发送GET和POST请求（使用NSURLSession）
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 }
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
代码执行结果：
