iOS网络-03-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];
    

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