OC - 15.NSURLSession与NSURLSessionTask

简介

---

• NSURLSession也能完成网络请求
• NSURLConnection在iOS9中不推荐使用，NSURLSession是iOS9中推荐使用的网络请求方式
• NSURLSession需要与NSURLSessionTask配合使用

• NSURLSession的简单使用步骤

  • 创建请求任务
  • 执行请求任务

• 通常使用NSURLSessionTask的子类来创建任务

NSURLSession

---

• NSURLSession对象的获取方法

  • 获取全局的NSURLSession对象（无法设置代理）

    + (NSURLSession *)sharedSession

  • 通过NSURLSessionConfiguration获取（可以设置代理），NSURLSessionConfiguration类通常用来设置一些请求参数

    + (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(nullable id <NSURLSessionDelegate>)delegate delegateQueue:(nullable NSOperationQueue *)queue

NSURLSessionTask

---

• 常用的属性

  • taskIdentifier(NSUInteger, readonly)，任务标识，唯一确定一个任务
  • originalRequest(NSURLRequest *, readonly)，上一个请求对象
  • currentRequest(NSURLRequest *, readonly)，当前请求对象
  • response(NSURLResponse *, readonly)，服务器的响应数据
  • countOfBytesReceived(int64_t, readonly)，已经接收到的数据量
  • countOfBytesExpectedToReceive(int64_t, readonly)，所要接收到的总数据量
  • countOfBytesSent(int64_t, readonly)，已经发送的数据量
  • countOfBytesExpectedToSend(int64_t, readonly)，所要发送的总数据量
  • taskDescription(NSString *)，任务描述
  • state(NSURLSessionTaskState, readonly)，任务的状态
  • error(NSError *, readonly)，错误信息
  • priority(float)，任务的优先级

• 常用的方法(任务的状态控制)

  • - (void)cancel，取消任务
  • - (void)suspend，暂停任务
  • - (void)resume，继续任务

• 任务优先级属性priority的取值

  • NSURLSessionTaskPriorityDefault
  • NSURLSessionTaskPriorityLow
  • NSURLSessionTaskPriorityHigh

• NSURLSessionTask

  • NSURLSessionDataTask，该子类没有扩充属性和方法，只是为了与NSURLSessionUploadTask和NSURLSessionDownloadTask区分
  • NSURLSessionUploadTask，用于上传任务

  • NSURLSessionDownloadTask，提供了一个取消任务的方法，但是会保存用于以后继续任务的信息，方法如下：

    - (void)cancelByProducingResumeData:(void (^)(NSData * __nullable resumeData))completionHandler;

与NSURLSession相关的代理协议

---

• NSURLSessionDelegate
• NSURLSessionTaskDelegate，遵守NSURLSessionDelegate协议

• NSURLSessionDataDelegate，遵守NSURLSessionTaskDelegate协议，是网络请求通常遵循的协议，常用的方法：

  • 接受到服务响应时调用的方法

    - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler;
    /**
    * 必须在该方法中对服务器的响应进行授权，才能继续接收服务器返回的数据，调用如下函数
    * completionHandler(NSURLSessionResponseAllow)
    */

  • 接收到服务器返回的数据时调用的方法

    - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
    /**
    * data：服务返回的数据，通常为JSON格式数据
    */

  • 请求完成时调用的方法（成功或失败）

    - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(nullable NSError *)error
    /**
    * 若出现错误，error中存放错误信息
    */

• NSURLSessionDownloadDelegate（通常用于下载大量数据），遵守NSURLSessionTaskDelegate协议，常用的方法：

  • 写入数据到临时文件时调用的方法（服务器返回一点就写入一点）

    - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
    /**
    * totalBytesWritten，已写入数据的总长度
    * totalBytesExpectedToWrite：总共要写入数据的总长度
    * 可以在该方法中计算下载进度
    */

  • 遇到错误的时候调用

    - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
    /**
    *error：若遇到错误，则保存错误信息
    */

  • 用于断点下载的方法

    - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
    /**
    * fileOffset：继续下载时，文件的开始位置
    * expectedTotalBytes：剩余的数据总数
    */

  • 下载完成时调用的方法

    - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
    /**
    * location：下载的文件保存的临时位置
    * 需要将下载的文件保存在可以长期保存的位置
    */

NSURLSession网络请求

---

• Block回调的方式

  • 获取NSURLSession对象

    NSURLSession *session =[NSURLSession sharedSession];

  • 创建请求任务

    NSURLSessionTask *task = [session downloadTaskWithURL:(此处为请求的URL路径) completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
    	//此处为请求任务完成后的回调Block，即：任务完成后会执行这里的代码
    	}];

  • 启动任务

    [task resume];

• 代理的方式

  • 获得NSURLSession对象

    NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];

  • 创建请求任务

    NSURLSessionTask *task = [session dataTaskWithRequest:（此处为NSURLRequest对象）];

  • 启动任务

    [task resume];

  • 实现代理方法做进一步处理