配置NSURLSession
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
configuration.timeoutIntervalForRequest = 8.0f;
configuration.requestCachePolicy = NSURLRequestUseProtocolCachePolicy;
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:[NSOperationQueue mainQueue]];
NSURLSessionConfiguration 用于配置NSURLSession,有三种配置类型:
- defaultSession 默认配置,缓存、证书、和cookies的储存都放在公公共区域,这里和NSURLConnection没有区别,一般的任务都选择该配置。
- ephemeralSession 缓存、证书、和 cookies将不会被储存在磁盘上,一般用于私密浏览.
- backgroundSession IOS系统单独开一个线程来处理, 提供了后台执行任务的能力,即使APP退出、挂起、崩溃,也能执行任务,不过backgroundSession只能用于上传或是下载.
NSURLSessionConfiguration 还提供了控制NSURLSession的行为,比如设置超时时间、是否允许使用蜂窝数据、缓存类型等。这些配置在NSURLConnection中是在NSURLRequest中配置,如果您正在使用NSURLSession,请直接在NSURLSessionConfiguration中配置,因为一个NSURLSession有可能包含多个网络请求,这样就可以统一处理.对于NSURLSessionConfiguration的其它特性,请参考网络上的其它文章,我这里简单的设置了超时时间为8秒,缓存使用HTTP协议缓存.
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:[NSOperationQueue mainQueue]];表示构造session的方式,可以用系统提供的委托,和自定义的委托,系统提供的委托,使用起来简单,但是不够灵活,也不能很好的了解session delegate的生命周期,并且有很多任务,必须使用自定义委托,比如后台任务,证书认证等。因此这里我使用了自定义的委托,在主线程执行.
配置任务
NSString *urlString = @"http://static.cnblogs.com/images/icon_addcomment.gif";
urlString = [urlString stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"GET";
NSURLSessionDataTask *task = [session dataTaskWithRequest:request];
[task resume];
这段代码前面没什么可说的,给一个request配置URL,设置请求方法,关键在倒数第二行创建任务,有如下三种类型的任务(它们都是NSURLSessionTask的子类):
- NSURLSessionDataTask 用NSData对象来发送和接收数据,即数据在你村中,dataTask通常用于和服务器交互简短的数据,接口的交互,通常使用NSURLSessionDataTask.
- NSURLSessionDownloadTask 数据将会以文件的形式来接收,下载完成之后,会将数据放在文件中,数据将不会出现在内存中,下载任务支持后台下载,即使App不再运行。
- NSURLSessionUploadTask 传送文件的时候,要生成该任务,也支持后台上传。文件上传请参考我的另一篇博客:NSURLSession文件上传
生成一个任务之后,需要手动开始,即调用task resume,NSURLSession还支持暂停和继续,这位断点续传提供了可能。NSURLConnection是不支持暂停,只能取消.
NSURLSessionDelegate
当生成的任务执行resume之后,NSURL加载系统,会启用一个线程,异步地从服务端拉取数据,在拉取数据的过程中,通过回调的方式,来控制拉取数据的过程。NSURLSession协议族,为网络请求提供了大量的回调,比如重定向、基于HTTPS的认证、数据传输,下载等。我们需要了解的是数据请求,需要实现的协议,其它的用于下载和上传的在我的另外两篇博文中(NSURLSession文件下载和NSURLSession文件上传有详细介绍,为了简便,NSURLSession的HTTP认证,也没打算实现,后面我会写一篇博客专门介绍HTTPS认证。
HTTPResponse
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
NSDictionary *headers = [self.currentRequest allHTTPHeaderFields];
NSLog(@"当前header=%@",headers);
NSLog(@"收到了response%@",response);
completionHandler(NSURLSessionResponseAllow);
}
当发起网络请求之后,服务器,首先会返回响应头,苹果对响应头进行了封装, 即NSURLResponse和NSURLHTTPResponse,NSURLHTTPResponse是专门对HTTP响应头的封装,包括headers 等, headers储存了HTTP头的相关信息,比如缓存信息、服务器时间等,HTTP协议详解请参考网络上的其它文章,completionHandler决定是否继续请求,NSURLSessionResponseDisposition 有如下可能值:
- NSURLSessionResponseCancel 取消当前请求,相当于调用task cancel.
- NSURLSessionResponseAllow 允许继续请求数据,可以进行后续工作,比如拉取数据。
- NSURLSessionResponseBecomeDownload 将拉取的数据,转变为下载任务,需要实现下载的回调,,设置为该值,可以将数据下载到文件中。
- NSURLSessionResponseBecomeStream 通过 stream来操作,对于数据操作我们一般选择NSURLSessionResponseAllow,如果需要将数据通过文件储存起来,才会设置为NSURLSessionResponseBecomeDownload。stream很少用。
receiveData
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
NSLog(@"接受到数据");
}
当HTTP服务器返回一个response之后,并且NSURLSessionResponseDisposition 的值为: NSURLSessionResponseAllow,该回调会被执行,我这里只是打印了文本,表示正在接收数据。
cacheResponse
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask willCacheResponse:(NSCachedURLResponse *)proposedResponse completionHandler:(void (^)(NSCachedURLResponse * _Nullable))completionHandler
{
NSLog(@"将要缓存,用户决定是否缓存");
completionHandler(proposedResponse);
}
当数据接收完成之后,系统会执行该回调,让用户来决定是否缓存数据,我这里将数据缓存起来,如果completionHandler(nil)表示不缓存数据,缓存这一块,我会专门开一篇博文来介绍。这里只是说明数据请求的流程。
完成处理
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
NSLog(@"任务完成");
if ( error ) {
NSLog(@"任务失败错误信息为:%@",error);
}else{
NSLog(@"任务成功");
NSString *path = NSTemporaryDirectory();
NSLog(@"任务的路径为:%@",path);
}
}
任何任务(数据任务、上传任务、下载任务)完成都会执行该回调,error不为空表示传输过程中出现了错误,比如超时、本地错误等。表明真个请求请求完成。
总结
NSURLSession异步数据请求逻辑并不复杂,分为以下几步:
1、配置session的类型(默认配置、后台、私密).
2、构造NSURLRequest,通过配置好了的NSURLSession生成NSURLSessionDataTask,并开始任务
3、执行response的回调,决定下一步的行为,是取消请求?还是转变为下载?或者是继续请求。
4、如果是继续请求,没有转为下载任务,执行receiveData回调,该回调会被调用多次,因此需要将多次返回的NSData拼起来.
5、receiveData回调多次结束之后,表示数据下载完成了,再决定是否缓存。
6、缓存处理也完成之后,表明整个请求也就完成了。
网友评论