[iOS-Foundation] NSURLSessionTas

在 URL session 中，一个 task 代表了一次特定的请求，通过NSURLSession对象的方法可以创建不同种类的 task。NSURLSessionTask 类是所有不同的 task 类的基类，它的子类包括
NSURLSessionDataTask，NSURLSessionUploadTask，NSURLSessionDownloadTask，NSURLSessionStreamTask。

• NSURLSessionDataTask将响应内容以NSData对象的形式返回，不能用在 background session 中。
• NSURLSessionUploadTask是NSURLSessionDataTask的子类，同样将响应内容以NSData对象的形式返回，区别是通过代理可以查看请求时上传内容的过程，且该 task 可用在 background session 中。
• NSURLSessionDownloadTask则是将资源以文件的形式下载到硬盘中，没有 session 类型的限制。
• NSURLSessionStreamTask则是建立了一个 TCP/IP 连接。

控制 task 的状态

task 的当前状态由枚举类型NSURLSessionTaskState的属性 state 表示，包含以下几种可能的值：

typedef NS_ENUM(NSInteger, NSURLSessionTaskState) {
    NSURLSessionTaskStateRunning = 0,
    NSURLSessionTaskStateSuspended = 1,
    NSURLSessionTaskStateCanceling = 2, /*当向task发送cancel消息后，会转变为该状态，代理会收到- URLSession:task:didCompleteWithError:消息*/
    NSURLSessionTaskStateCompleted = 3, /*完成状态不包括被取消的情况*/
};

通过NSURLSession 创建的 task 默认是状态是 suspended，调用- resume 方法后，task 的状态变为 running。通过- suspend 方法可以将 task 重新变为挂起状态，当恢复 running 状态时，download task 可以从中断的地方继续传输，而其他 task 都需要重新开始。当调用- cancel 方法后，task 变为 canceling 状态，在发送给 delegate 的URLSession:task:didCompleteWithError:消息中，error 参数的 domain 为NSURLErrorDomain，code 为NSURLErrorCancelled。

相关信息

• originalRequest，创建 task 时对应的请求对象。
• currentRequest，当响应为重定向到其他 URL 时，该值会改变。
• response，服务端返回的NSURLResponse对象。
• taskIdentifier，NSUInteger类型，task 在 session 内的唯一标识。
• error，当任务失败时的NSError对象。
• taskDescription，可给任务设置一个可读的描述，在如果需要界面展示时使用。

进度信息

• countOfBytesExpectedToSend，请求体的字节数，系统根据 header 中的 Content-Length 字段，或者作为请求体的NSData或文件的大小来设置该值。
• countOfBytesSent，已发送的请求体字节数，当该值变化，会触发代理方法
  -URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:
• countOfBytesExpectedToReceive，响应体期望收到的字节数，根据响应 header 中的 Content-Length 字段，若未指明，则该值为
  NSURLSessionTransferSizeUnknown(-1)
• countOfBytesReceived，已收到的响应体字节数，当该值变化，会触发代理方法- URLSession:dataTask:didReceiveData:或
  URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:

优先级

task 有一个priority属性，接受0到1之间的浮点数，通过每一个 task 不同的 priority 值，可以提示系统 task 执行的优先级，1为最高，0为最低。默认值是NSURLSessionTaskPriorityDefault，即 0.5。系统提供了3个常量值：

NSURLSessionTaskPriorityDefault //0.5
NSURLSessionTaskPriorityLow // 0
NSURLSessionTaskPriorityHigh // 1

Task 子类

NSURLSessionDataTask和NSURLSessionUploadTask都没有再实现额外的方法，它们只是用来区分不同的 task。而NSURLSessionDownloadTask除了用来区分 task，还额外实现了一个方法- cancelByProducingResumeData:，这个方法调用了基类NSURLSessionTask中的- cancel方法，参数 completionHandler 要求传入一个 block，用来处理已传输的数据 resume data，这个 resume data 将来可用于 session 的- downloadTaskWithResumeData:方法，以便继续中断的下载。