iOS网络开发（3）使用NSURLSession

NSURLSession介绍

NSURLSession在iOS7.0开始引入，在框架中的地位与NSURLConnection并列
NSURLSession能够完成所有NSURLConnection的功能，并且进行了非常大的功能扩充

从iOS9.0开始，苹果正式弃用NSURLConnection

下图为NSURLSession的使用过程涉及到的主要类即它们之间的关系




三种工作模式：
默认会话模式：类似于NSURLConnection，使用磁盘缓存
瞬时会话模式：不使用磁盘缓存
后台会话模式：在程序进入后台时也能上传或下载

NSURLSessionConfigration用于生成这三种工作模式的配置，方法如下

+ (NSURLSessionConfiguration *)defaultSessionConfiguration
+ (NSURLSessionConfiguration *)ephemeralSessionConfiguration
+ (NSURLSessionConfiguration *)backgroundSessionConfigurationWithIdentifier:(NSString *)identifier

NSURLSession会话对象的创建：

// 使用默认会话模式、默认的缓存、cookie及credential
+ (NSURLSession *)sharedSession
// 使用指定的工作模式
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration*)configuration
// 使用指定的工作模式、任务运行时的队列、代理
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration*)configuration delegate:(id<NSURLSessionDelegate>)delegate delegateQueue:(NSOperationQueue *)queue

NSURLSession发送网络请求的使用步骤：
a. 创建任务对象
b. 控制任务的执行
c. 在block或代理方法中获得任务执行的结果

支持的三种任务：（任务的基类NSURLSessionTask）
数据任务 使用NSURLSessionDataTask描述
下载任务 使用NSURLSessionDownloadTask描述
上传任务 使用NSURLSessionUploadTask描述

任务对象的

NSURLSession中的任务对象NSURLSessionTask，全部由NSURLSession对象创建
强调：异步操作不会阻塞当前代码的执行，无法通过返回值或参数获得结果

NSURLSessionTask任务对象的状态：

@property(readonly) NSURLSessionTaskState state
typedef NS_ENUM (NSInteger, NSURLSessionTaskState ) {
NSURLSessionTaskStateRunning = 0,     // 运行状态
NSURLSessionTaskStateSuspended = 1,   // 挂起状态
NSURLSessionTaskStateCanceling = 2, // 取消状态
NSURLSessionTaskStateCompleted = 3, // 完成状态
};

当一个任务对象被创建后，任务的状态为挂起状态
控制任务执行（修改任务状态）的方法：

- (void)cancel     // 取消任务
- (void)resume     // 运行任务
- (void)suspend    // 挂起任务

数据任务 — block方式获得结果

数据任务创建：

- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError *error))completionHandler
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError*error))completionHandler

在block中处理请求后的结果（响应数据、响应对象、错误对象）

如：发送一个GET请求，获取指定游戏任务信息的JSON数据

NSString *urlStr = @"http://localhost/lolShow.php?number=20&from=0";
NSURL * url = [NSURL URLWithString:urlStr];
NSURLRequest * request = [NSURLRequest requestWithURL:url];
//创建数据任务
NSURLSession * session = [NSURLSession sharedSession];
NSURLSessionDataTask * dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * __nullable data, NSURLResponse * __nullable response, NSError * __nullable error) {
if ( error ) {
NSLog(@"1 %@", [error localizedDescription]);
return ;
}
//将JSON数据序列化为OC对象
NSArray * arr = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
if ( error ) {
NSLog(@"2 %@", [error localizedDescription]);
return ;
}
//字典转模型
for (NSDictionary * dict in arr ) {
AMHeroModel * model = [AMHeroModel heroModelWithDict:dict];
[self.heroInfoArray addObject:model];
}
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
[self stopLoading];//刷新UI
}];
}];
//启动任务
[dataTask resume];

数据任务 — 代理方式获得结果

数据任务的创建：

- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request

NSURLSession的代理属性

@property(readonly, retain) id< NSURLSessionDelegate > delegate

涉及的代理协议： <NSURLSessionDelegate><NSURLSessionTaskDelegate>
<NSURLSessionDataDelegate><NSURLSessionDownloadDelegate>

数据任务常用的代理方法：

//接收到应答对象
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask*)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler
//接收到数据（可能执行多次）
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask*)dataTask didReceiveData:(NSData *)data
//完成一个请求的应答过程
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error