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)
- 示例代码:
- (void)getRequest_A { // 对请求路径的说明 // http://120.25.226.186:32812/login?username=520it&pwd=520&type=JSON // 协议头+主机地址+接口名称+?+参数1&参数2&参数3 // 协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login)+?+参数1(username=520it)&参数2(pwd=520)&参数3(type=JSON) // GET请求,直接把请求参数跟在URL的后面以?隔开,多个参数之间以&符号拼接 // 1.确定请求路径 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; // 2.创建请求对象 // 请求对象内部默认已经包含了请求头和请求方法(GET) NSURLRequest *request = [NSURLRequest requestWithURL:url]; // 3.获得会话对象 NSURLSession *session = [NSURLSession sharedSession]; // 4.根据会话对象创建一个Task(发送请求) /* 第一个参数:请求对象 第二个参数:completionHandler回调(请求完成【成功|失败】的回调) data:响应体信息(期望的数据) response:响应头信息,主要是对服务器端的描述 error:错误信息,如果请求失败,则error有值 */ NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { if (error == nil) { // 6.解析服务器返回的数据 // 说明:(此处返回的数据是JSON格式的,因此使用NSJSONSerialization进行反序列化处理) NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; NSLog(@"%@",dict); } }]; // 5.执行任务 [dataTask resume];}
- 发送GET请求的第二种方法
- (void)getRequest_B { // 1.确定请求路径 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; // 2.获得会话对象 NSURLSession *session = [NSURLSession sharedSession]; // 3.根据会话对象创建一个Task(发送请求) /* 第一个参数:请求路径 第二个参数:completionHandler回调(请求完成【成功|失败】的回调) data:响应体信息(期望的数据) response:响应头信息,主要是对服务器端的描述 error:错误信息,如果请求失败,则error有值 注意: 1)该方法内部会自动将请求路径包装成一个请求对象,该请求对象默认包含了请求头信息和请求方法(GET) 2)如果要发送的是POST请求,则不能使用该方法 */ NSURLSessionDataTask *dataTask = [session dataTaskWithURL:url completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { // 5.解析数据 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; NSLog(@"%@",dict); }]; // 4.执行任务 [dataTask resume];}
执行结果:
- 此处打印的值是一个字典,字典中success这个key对应的value打印出来为Unicode编码的,如果想输出中文,可以为NSDictionary提供一个分类,重写系统中的方法。
#import "NSDictionary+Log.h"@implementation NSDictionary (Log)- (NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level { // 初始化可变字符串 NSMutableString *string = [NSMutableString string]; // 拼接开头[ [string appendString:@"["]; // 拼接字典中所有的键值对 [self enumerateKeysAndObjectsUsingBlock:^(id _Nonnull key, id _Nonnull obj, BOOL * _Nonnull stop) { [string appendFormat:@"%@:",key]; [string appendFormat:@"%@",obj]; }]; // 拼接结尾] [string appendString:@"]"]; return string;}@end
- 字典分类中重写系统方法
- 执行结果:
2、发送POST请求
- 使用NSURLSession发送POST请求的方法和NSURLConnection类似,整个过程如下:
- 1)确定请求路径(一般由公司的后台开发人员以接口文档的方式提供)
- 2)创建可变的请求对象(因为需要修改),此步骤不可以省略
- 3)修改请求方法为POST
- 4)设置请求体,把参数转换为二进制数据并设置请求体
- 5)创建会话对象(NSURLSession)
- 6)根据会话对象创建请求任务(NSURLSessionDataTask)
- 7)执行Task
- 8)当得到服务器返回的响应后,解析数据(XML|JSON|HTTP)
- 示例代码:
- (void)post { // 对请求路径的说明 // http://120.25.226.186:32812/login // 协议头+主机地址+接口名称 // 协议头(http://)+主机地址(120.25.226.186:32812)+接口名称(login) // POST请求需要修改请求方法为POST,并把参数转换为二进制数据设置为请求体 // 1.创建会话对象 NSURLSession *session = [NSURLSession sharedSession]; // 2.根据会话对象创建task NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login"]; // 3.创建可变的请求对象 NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url]; // 4.修改请求方法为POST request.HTTPMethod = @"POST"; // 5.设置请求体 request.HTTPBody = [@"username=520it&pwd=520it&type=JSON" dataUsingEncoding:NSUTF8StringEncoding]; // 6.根据会话对象创建一个Task(发送请求) /* 第一个参数:请求对象 第二个参数:completionHandler回调(请求完成【成功|失败】的回调) data:响应体信息(期望的数据) response:响应头信息,主要是对服务器端的描述 error:错误信息,如果请求失败,则error有值 */ NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { // 8.解析数据 NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]; NSLog(@"%@",dict); }]; // 7.执行任务 [dataTask resume];}
4、NSURLSession代理方法简单介绍
- 有的时候,我们可能需要监听网络请求的过程(如下载文件需监听文件下载进度),那么就需要用到代理方法。
- 接下来通过代码简单说明NSURLSession中普通网络请求会涉及代理方法的使用
#import "ViewController.h"@interface ViewController ()@property (nonatomic, strong) NSMutableData *responseData;@end@implementation ViewController- (NSMutableData *)responseData { if (_responseData == nil) { _responseData = [NSMutableData data]; } return _responseData;}// 当点击控制器View的时候会调用该方法- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event { [self delegateTest];}// 发送请求,代理方法- (void)delegateTest { // 1.确定请求路径 NSURL *url = [NSURL URLWithString:@"http://120.25.226.186:32812/login?username=520it&pwd=520it&type=JSON"]; // 2.创建请求对象 // 请求对象内部默认已经包含了请求头和请求方法(GET) NSURLRequest *request = [NSURLRequest requestWithURL:url]; // 3.获得会话对象,并设置代理 /* 第一个参数:会话对象的配置信息defaultSessionConfiguration 表示默认配置 第二个参数:谁成为代理,此处为控制器本身即self 第三个参数:队列,该队列决定代理方法在哪个线程中调用,可以传主队列|非主队列 [NSOperationQueue mainQueue] 主队列: 代理方法在主线程中调用 [[NSOperationQueue alloc]init] 非主队列: 代理方法在子线程中调用 */ NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]]; // 4.根据会话对象创建一个Task(发送请求) NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request]; // 5.执行任务 [dataTask resume];}// 1.接收到服务器响应的时候调用该方法- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler { // 在该方法中可以得到响应头信息,即response NSLog(@"didReceiveResponse--%@",[NSThread currentThread]); // 注意:需要使用completionHandler回调告诉系统应该如何处理服务器返回的数据 // 默认是取消的 /* NSURLSessionResponseCancel = 0, 默认的处理方式,取消 NSURLSessionResponseAllow = 1, 接收服务器返回的数据 NSURLSessionResponseBecomeDownload = 2,变成一个下载请求 NSURLSessionResponseBecomeStream 变成一个流 */ completionHandler(NSURLSessionResponseAllow);}// 2.接收到服务器返回数据的时候会调用该方法,如果数据较大那么该方法可能会调用多次- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data { NSLog(@"didReceiveData--%@",[NSThread currentThread]); //拼接服务器返回的数据 [self.responseData appendData:data];}// 3.当请求完成(成功|失败)的时候会调用该方法,如果请求失败,则error有值- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { NSLog(@"didCompleteWithError--%@",[NSThread currentThread]); if(error == nil) { //解析数据,JSON解析请参考http://www.cnblogs.com/wendingding/p/3815303.html NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self.responseData options:kNilOptions error:nil]; NSLog(@"%@",dict); }}@end
- 代码执行结果: