前两节完成了NSURLSession的创建。这一节的主要目的是通过Session创建NSURLSessionDataTask,完成通信交换并分析整个通信过程。分为以下几个步骤:
- NSURLSessionDataTask的创建;
- 请求的发送和取消
- 请求过程的分析
1 创建NSURLSessionTask
苹果供提供了5中SessionTask,其关系如下:
其中NSURLSessionTask是不能承接数据发送任务的。我们最常用的就是NSURLSessionDataTask。在上一节分析NSURLSession时已经讲到过有两种方式创建NSURLSessionDataTask。分别是以block和delegate接受数据。NSURLSession给我们提供了很多的方法来完成这件事,这里就挑几个我们常用的来稍微说明下:
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request;
- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url;
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error))completionHandler;
- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error))completionHandler;
上面这四个方法是我们最常用的用来生成NSURLSessionDataTask的方法。比较清楚不再赘述。
2 请求的发送和取消
请求的发送很简单,只有一个方法resume。task对象生成后只有调用该方法才能把请求发送出去。方法如下:
// NSURLSessionTask
- (void)resume;
2 取消请求
请求的取消分为两个层面:NSURLSessionTask层暂停和取消当次任务;NURLSession层停止整个session的请求。
2.1 暂停取消当次任务
这里有两个方法:suspend,cancel。
// NSURLSessionTask
- (void)suspend;
- (void)cancel;
suspend是暂停当次任务。会停止当次任务的传输,同时,task处于暂停状态期间,它的timeout属性会暂时失效。
cancel会立即返回,它会停止数据的发送和接受。
2.2 停止session
一个session上可以有多个数据请求,如果停止了session,那么其上的所有请求都将失效。这里有两个方法:
// NSURLSession
- (void)invalidateAndCancel;
- (void)finishTasksAndInvalidate;
这里就有个问题,何时停掉session?如果一个session上只要一个数据请求任务,当然可以任务结束时就停掉session。但是如果一个session上有多个任务,那么何时停掉session就会是个问题。因为session如果不停掉,那么它将会一直持有delegate。这个问题会在后面讨论,以及session的内存管理问题。
3 处理请求过程
请求处理的过程其实就是delegate调用的过程。delegate有两种分类方法:1,按类别分类;2,按功能分类。第一种是官方的,第二种是我自己分的。
按类别分为5类:
- NSURLSessionDelegate
- NSURLSessionTaskDelegate
- NSURLSessionDataDelegate
- NSURLSessionDownloadDelegate
- NSURLSessionStreamDelegate
关系图如下:
这种分类是控制层级由大到小。NSURLSessionDelegate控制session通道的建立,比如SSL通道的建立。NSURLSessionTaskDelegate控制请求任务的公共属性,比如重定向、请求进度、请求结束。后面三个每一种请求任务中独有的属性,比如NSURLSessionDataDelegate中要接收请求的进度,NSURLSessionDownloadDelegate要处理下载完成的任务。
按功能分类,可以分类三种:认证相关的delegate,常用的delegate和不常用的delegate。
认证相关的delegate单独在认证的时候环节分析,这里只看一下常用的delegate。
3.1 常用sessiondelegate
共有5个常用的sessiondelegate。其中有NSURLSessionTaskDelegate有两个,如下:
// 方法1,决定重定向是否继续
- (void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
willPerformHTTPRedirection:(NSHTTPURLResponse *)response
newRequest:(NSURLRequest *)request
completionHandler:(void (^)(NSURLRequest * _Nullable))completionHandler {
// 如需要重定向请求就调用completionHandlercompletionHandler
if (completionHandler) {
completionHandler(request);
}
}
// 方法2,请求完成
- (void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
didCompleteWithError:(nullable NSError *)error {
// 每个次datatask完成都会调用此方法
}
NSURLSessionDataDelegate有三个,如下:
// 方法3,收到响应头
- (void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
didReceiveResponse:(NSURLResponse *)response
completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler{
// 处理完响应头,如先继续请求,一定要调用
if (completionHandler) {
completionHandler(NSURLSessionResponseAllow);
}
}
// 方法4,收到数据,可能调用多次
- (void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
didReceiveData:(NSData *)data{
// 接收响应体,可能会调用多次
}
// 方法5,否需要cache请求
- (void)URLSession:(NSURLSession *)session
dataTask:(NSURLSessionDataTask *)dataTask
willCacheResponse:(NSCachedURLResponse *)proposedResponse
completionHandler:(void (^)(NSCachedURLResponse * _Nullable cachedResponse))completionHandler{
// completionHandler必须要调用,如不想缓存completionHandler的参数传null
if (completionHandler) {
completionHandler(proposedResponse);
}
}
他们大致的职责范围是:NSURLSessionTaskDelegate控制一个请求的开始和结束,NSURLSessionDataDelegate控制数据交换过程。
其中方法1只有在请求发生重定向时才会被调用,如果想要重定向请求,则需要调用completionHandler,参数是newRequest。否则,不能重定向请求。任何请求结束时都会调用方法2。当收到http请求的应答头,即response head时就会调用方法3。其中response就是http的响应头。处理完响应头,如果想继续请求需要调用completionHandler,否则请求将不会继续。http的响应体数据将会在方法4中收到,方法4可能不止调用一次。方法5涉及到缓存,这个就比较麻烦了。数据接收完成后会调用这个方法。这个方法的completionHander必须要调用,否则会引起内存泄漏,具体为什么苹果没说,只是说必须要调用。这个方法的目的是改变某一个URL的缓存,比如不想缓存的话completionHander的参数传NULL。或者是该变NSCachedURLResponse的userinfo值。总之一句,有completionHandler参数的必须要调用该参数,否则,请求将无法继续。