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];
    • 实现代理方法做进一步处理

上一篇:利用python的requests发送http请求


下一篇:ionic 开发笔记