一. 前言
很多人都用过AFNetWorking和SDWebImage,其实底层就是封装了NSURLSession来请求任务。第三方用多了,对于苹果原生的网络请求知识却掌握得不够牢固,所以写这篇文章来总结回顾一下。
苹果在 iOS9 之后已经放弃了 NSURLConnection,所以在现在的实际开发中,一般使用的是 iOS7 之后推出的 NSURLSession。NSURLSession 和 NSURLConnection 都提供了与各种协议,诸如 HTTP 和 HTTPS ,进行交互的API。会话对象(NSURLSession 类对象)就是用于管理这种交互过程。它是一个高度可配置的容器,通过使用其提供的APPI,可进行细粒度的管理控制。它提供了在 NSURLConnection 中的所有特性,此外,它还可以实现 NSURLConnection 不能完成的任务,例如实现私密浏览。
总之,NSURLSession 有如下优势:
- NSURLSession 支持 http2.0 协议
- 在处理下载任务的时候可以直接把数据下载到磁盘(通过配置)
- 支持后台下载|上传(通过配置)
- 同一个 session 发送多个请求,只需要建立一次连接(复用了TCP)
- 提供了全局的 session 并且可以统一配置,使用更加方便
- 下载的时候是多线程异步处理,效率更高
一. NSURLSession的介绍
NSURLSession的配置和创建
NSURLSession对象是一个会话,你可以把他当成是生产网络请求任务的工厂。NSURLSession有三种工作模式:
-
默认会话模式(default):工作模式类似于原来的NSURLConnection,使用的是基于磁盘缓存的持久化策略,使用用户keychain中保存的证书进行认证授权。
-
瞬时会话模式(ephemeral):该模式不使用磁盘保存任何数据。所有和会话相关的caches,证书,cookies等都被保存在RAM中,因此当程序使会话无效,这些缓存的数据就会被自动清空。(可以实现私密浏览)
-
后台会话模式(background):该模式在后台完成上传和下载(在系统的一个单独的进程中执行),在创建Configuration对象的时候需要提供一个NSString类型的ID用于标识完成工作的后台会话。
简单点理解,就是不同的工作模式用来解决不同的网络请求场景,当你需要缓存会话相关的caches,证书,cookies等是就使用默认会话模式,不需要就用瞬时会话模式,需要在后台进行上传下载就用后台会话模式。
那怎么设置这些模式呢?
这些工作模式是由NSURLSessionConfiguration决定的。以下三种创建方式一一对应NSURLSession的三种工作模式,其实本质上还是NSURLSessionConfiguration内部属性所决定,也省得我们一一去设置。
+ (NSURLSessionConfiguration *)defaultSessionConfiguration;
+ (NSURLSessionConfiguration *)ephemeralSessionConfiguration;
+ (NSURLSessionConfiguration *)backgroundSessionConfiguration:(NSString *)identifier;
一个NSURLSessionConfiguration对象定义的行为和策略被用于使用NSURLSession上传和下载数据,创建一个配置对象始终是你必须采取的第一步。你可以使用这个对象去配置你想要使用的NSURLSession对象的超时时间、缓存策略、连接请求以及其它类型的信息。
以下我们了解下NSURLSessionConfiguration的常见属性(如果想了解更多属性,可以看这篇文章NSURLSessionConfiguration详解):
//如果在后台任务正在传输时程序退出,可以使用这个identifier在程序重新启动是创建一个新的configuration和session关联之前传输。
@property(readonly, copy) NSString *identifier;
//默认为空,NSURLRequest附件的请求头。
//这个属性会给所有使用该configuration的session生成的tasks中的NSURLRequest添加额外的请求头。
//如果这里边添加的请求头跟NSURLRequest中重复了,侧优先使用NSURLRequest中的头
@property(copy) NSDictionary *HTTPAdditionalHeaders;
//是否使用蜂窝网络,默认是yes.
@property BOOL allowsCellularAccess;
//给request指定每次接收数据超时间隔
//如果下一次接受新数据用时超过该值,则发送一个请求超时给该request。默认为60s
@property NSTimeInterval timeoutIntervalForRequest;
//给指定resource设定一个超时时间,resource需要在时间到达之前完成
//默认是7天。
@property NSTimeInterval timeoutIntervalForResource;
//discretionary属性为YES时表示当程序在后台运作时由系统自己选择最佳的网络连接配置,该属性可以节省通过蜂窝连接的带宽。
//在使用后台传输数据的时候,建议使用discretionary属性,而不是allowsCellularAccess属性,因为它会把WiFi和电源可用性考虑在内。
@property (getter=isDiscretionary) BOOL discretionary;
//表示当后台传输结束时,是否启动app.这个属性只对 生效,其他configuration类型会自动忽略该值。默认值是YES。
@property BOOL sessionSendsLaunchEvents;
//是否启动通道,可以用于加快网络请求,默认是NO
@property BOOL HTTPShouldUsePipelining;
/===========储存的相关属性=============/
//存储cookie,清除存储,直接set为nil即可。
//对于默认和后台的session,使用sharedHTTPCookieStorage。
//对于短暂的session,cookie仅仅储存到内存,session失效时会自动清除。
@property(retain) NSHTTPCookieStorage *HTTPCookieStorage;
//默认为yes,是否提供来自shareCookieStorge的cookie
//如果想要自己提供cookie,可以使用HTTPAdditionalHeaders来提供。
@property BOOL HTTPShouldSetCookies;
//证书存储,如果不使用,可set为nil.
//默认和后台session,默认使用的sharedCredentialStorage.
//短暂的session使用一个私有存储在内存中。session失效会自动清除。
@property(retain) NSURLCredentialStorage *URLCredentialStorage;
//缓存NSURLRequest的response。
//默认的configuration,默认值的是sharedURLCache。
//后台的configuration,默认值是nil
//短暂的configuration,默认一个私有的cache于内存,session失效,cache自动清除。
@property(retain) NSURLCache *URLCache;
//缓存策略,用于设置该会话中的Request的cachePolicy,如果Request有单独设置的话,以Request为准。
//默认值是NSURLRequestUseProtocolCachePolicy
@property NSURLRequestCachePolicy requestCachePolicy;
那我们该怎么创建想要的会话对象呢?总共有三种创建方式,我们可以创建对应的配置类(NSURLSessionConfiguration)来配置。
//使用静态的sharedSession方法,该类使用共享的会话,该会话使用全局的Cache,Cookie和证书
+ (NSURLSession *)sharedSession;
//通过sessionWithConfiguration:方法创建对象,也就是创建对应配置的会话,与NSURLSessionConfiguration合作使用
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration;
//通过设置配置、代理、队列来创建会话对象
+ (NSURLSession *)sessionWithConfiguration:(NSURLSessionConfiguration *)configuration delegate:(id <NSURLSessionDelegate>)delegate delegateQueue:(NSOperationQueue *)queue;
二三两种方式可以创建一个新会话并定制其会话类型。该方式中指定了session的委托和委托所处的队列。当不再需要连接时,可以调用Session的invalidateAndCancel
直接关闭,或者调用finishTasksAndInvalidate
等待当前Task结束后关闭。这时Delegate会收到URLSession:didBecomeInvalidWithError:
这个事件。Delegate收到这个事件之后会被解引用。
NSURLSession支持的任务
之前提到的,NSURLSession对象生产网络请求任务的工厂,它能生成出三种类型的任务:加载数据,下载和上传。而这个任务类就是NSURLSessionTask。
NSURLSessionTask 是一个抽象类,如果要使用那么只能使用它的子类。
- NSURLSessionDataTask,可以用来处理一般的网络请求,如 GET | POST 请求等。
- NSURLSessionUploadTask,用于处理上传请求。
- NSURLSessionDownloadTask,主要用于处理下载请求。
下面我们来详细介绍下三种任务:
① NSURLSessionDataTask
我们可以通过request对象或url创建NSURLSessionDataTask对象。也可以选择用代理或者Block来接收数据。
//这两个方法需要设置代理来接收数据
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request;
- (NSURLSessionDataTask *)dataTaskWithURL:(NSURL *)url;
//这两个方法在completionHandler来接收数据
- (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;
使用Block的回调接收数据的方法比较简洁,但是却没有设置代理,通过代理获取数据来得灵活。这边重点介绍代理的方式,顺便回顾一下上面所讲的NSURLSession的配置和创建。
以下就分别举两个例子来说明(代理和Block):
(1)代理的方式:
代理的方式的话需要设置代理人,遵守协议NSURLSessionDelegate和NSURLSessionTaskDelegate。
说到协议,几个类都有对应的协议,比如NSURLSessionDataTask就对应NSURLSessionDataDelegate,该协议主要用来处理dataTask的数据处理(比如接收到响应,接收到数据,是否缓存数据)。另外,也经常需要遵守公共的协议:NSURLSessionDelegate和NSURLSessionTaskDelegate。
NSURLSessionDelegate主要关于会话的,比如会话关闭,会话收到挑战。
NSURLSessionTaskDelegate主要关于任务的,可以理解为任务共用的协议,比如任务完成或失败,任务收到挑战,任务将要执行HTTP重定向。
还有一个重点,就是关于缓存。
之前提到的NSURLSession默认的会话模式,也就是defaultSessionConfiguration的配置,可以将缓存存储在磁盘上(本质就是使用NSURLCache,具体介绍可以看这边文章NSURLCache缓存使用简介)。
路径是沙盒路径下Library/Caches/bundid/Cache.db
(对于webview的缓存,也一样,因为它也是用的NSURLCache)。
另外,还有一个常见的设置就是cachePolicy(缓存策略),该设置决定要不要从缓存中获取,比如request.cachePolicy = NSURLRequestUseProtocolCachePolicy
。以下还有几种策略:
typedef NS_ENUM(NSUInteger, NSURLRequestCachePolicy)
{
//对特定的 URL 请求使用网络协议中实现的缓存逻辑。这是默认的策略。
NSURLRequestUseProtocolCachePolicy = 0,
//数据需要从原始地址加载。不使用现有缓存。
NSURLRequestReloadIgnoringLocalCacheData = 1,
// 不仅忽略本地缓存,同时也忽略代理服务器或其他中间介质目前已有的、协议允许的缓存。
NSURLRequestReloadIgnoringLocalAndRemoteCacheData = 4,
NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData,
//无论缓存是否过期,先使用本地缓存数据。如果缓存中没有请求所对应的数据,那么从原始地址加载数据。
NSURLRequestReturnCacheDataElseLoad = 2,
//无论缓存是否过期,先使用本地缓存数据。如果缓存中没有请求所对应的数据,那么放弃从原始地址加载数据,请求视为失败(即:“离线”模式)。
NSURLRequestReturnCacheDataDontLoad = 3,
//从原始地址确认缓存数据的合法性后,缓存数据就可以使用,否则从原始地址加载。
NSURLRequestReloadRevalidatingCacheData = 5,
};
例子中,我们设置了默认配置,请求的缓存策略为NSURLRequestReturnCacheDataElseLoad,这样当我们发送一个请求后,就会将数据和响应保存在沙盒中的数据库,当我们下次发送请求,会先从缓存中找,找不到再去服务器找。
#import "ViewController.h"
@interface ViewController ()<NSURLSessionDelegate,NSURLSessionTaskDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
[self sendRequest];
}
- (void)sendRequest{
//创建请求
NSURL *url = [NSURL URLWithString:@"http://httpbin.org/get"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
//设置request的缓存策略(决定该request是否要从缓存中获取)
request.cachePolicy = NSURLRequestReturnCacheDataElseLoad;
//创建配置(决定要不要将数据和响应缓存在磁盘)
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
//configuration.requestCachePolicy = NSURLRequestReturnCacheDataElseLoad;
//创建会话
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
//生成任务
NSURLSessionDataTask *task = [session dataTaskWithRequest:request];
//创建的task是停止状态,需要我们去启动
[task resume];
}
//1.接收到服务器响应的时候调用
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask
didReceiveResponse:(NSURLResponse *)response
completionHandler:(void (^)(NSURLSessionResponseDisposition disposition))completionHandler{
NSLog(@"接收响应");
//必须告诉系统是否接收服务器返回的数据
//默认是completionHandler(NSURLSessionResponseAllow)
//可以再这边通过响应的statusCode来判断否接收服务器返回的数据
completionHandler(NSURLSessionResponseAllow);
}
//2.接受到服务器返回数据的时候调用,可能被调用多次
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data{
NSLog(@"接收到数据");
//一般在这边进行数据的拼接,在方法3才将完整数据回调
// NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
}
//3.请求完成或者是失败的时候调用
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didCompleteWithError:(nullable NSError *)error{
NSLog(@"请求完成或者是失败");
//在这边进行完整数据的解析,回调
}
//4.将要缓存响应的时候调用(必须是默认会话模式,GET请求才可以)
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask
willCacheResponse:(NSCachedURLResponse *)proposedResponse
completionHandler:(void (^)(NSCachedURLResponse * _Nullable cachedResponse))completionHandler{
//可以在这边更改是否缓存,默认的话是completionHandler(proposedResponse)
//不想缓存的话可以设置completionHandler(nil)
completionHandler(proposedResponse);
}
@end
(2)Block的方式:
NSURL *url = [NSURL URLWithString:@"http://www.connect.com/login"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
request.HTTPMethod = @"POST";
request.HTTPBody = [@"username=Tom&pwd=123" dataUsingEncoding:NSUTF8StringEncoding];
//使用全局的会话
NSURLSession *session = [NSURLSession sharedSession];
// 通过request初始化task
NSURLSessionTask *task = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
NSLog(@"%@", [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil]);
}];
//创建的task是停止状态,需要我们去启动
[task resume];
② NSURLSessionUploadTask
UploadTask继承自DataTask。因为UploadTask只不过在Http请求的时候,把数据放到Http Body中。所以,用UploadTask来做的事情,通常直接用DataTask也可以实现。
NSURLSessionUploadTask通过request创建,在上传时指定文件源或数据源,可以用代理或Block指定任务完成后的回调代码。
/=========代理方式===========/
//通过文件url来上传
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromFile:(NSURL *)fileURL;
//通过文件data来上传
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromData:(NSData *)bodyData;
//通过文件流来上传
- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request;
/=========Block方式===========/
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromFile:(NSURL *)fileURL completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError *error))completionHandler;
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromData:(NSData *)bodyData completionHandler:(void (^)(NSData *data, NSURLResponse *response, NSError *error))completionHandler;
这三种上传方式分别针对什么应用场景呢?
- NSData:如果对象已经在内存里
- File:如果对象在磁盘上,这样做有助于降低内存使用
- Stream:通过流对象,你可以不用一次性将所有的流数据加载到内存中
不过使用Stream一定要实现URLSession:task:needNewBodyStream:
,因为Session没办法在重新尝试发送Stream的时候找到数据源。
这边我就举个上传图片的例子:
- (void)uploadRequest{
//创建请求
NSMutableURLRequest * request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"http://www.freeimagehosting.net/upload.php"]];
//如果是上传文字就是@"application/json"
[request addValue:@"image/jpeg" forHTTPHeaderField:@"Content-Type"];
[request addValue:@"text/html" forHTTPHeaderField:@"Accept"];
[request setHTTPMethod:@"POST"];
[request setCachePolicy:NSURLRequestReloadIgnoringCacheData];
[request setTimeoutInterval:20];
NSData * imagedata = UIImageJPEGRepresentation([UIImage imageNamed:@"person"],1.0);
//创建配置(决定要不要将数据和响应缓存在磁盘)
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
//创建会话
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
NSURLSessionUploadTask * uploadtask = [session uploadTaskWithRequest:request fromData:imagedata completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
//发送完成的回调
}];
[uploadtask resume];
}
//发送数据过程中会执行(执行多次)
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didSendBodyData:(int64_t)bytesSent totalBytesSent:(int64_t)totalBytesSent totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend{
NSLog(@"发送数据中");
//在这边监听发送的进度
//progress = totalBytesSent/(float)totalBytesExpectedToSend
}
③ NSURLSessionDownloadTask
在前面请求数据的时候就相当于一个简单的下载过程,所以说NSURLSessionDataTask也是可以做到简单下载功能的,比如下载图片(请求回图片数据)。
但是对比普通请求,NSURLSessionDownloadTask的功能更为强大:
- 下载文件可以实现断点下载
- 内部已经完成了边接收数据边写入沙盒的操作(直接下载到磁盘)
- 支持BackgroundSession(后台下载)
接下来我们来了解一下下载的API,除了通过url或request下载外,还可以通过之前已经下载的数据来创建下载任务(也就是我们说的断点续传)。同样地可以通过completionHandler指定任务完成后的回调代码块。
/=========代理方式===========/
- (NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request;
- (NSURLSessionDownloadTask *)downloadTaskWithURL:(NSURL *)url;
//通过之前已经下载的数据来创建下载任务
- (NSURLSessionDownloadTask *)downloadTaskWithResumeData:(NSData *)resumeData;
/=========Block方式===========/
- (NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURL *location, NSURLResponse *response, NSError *error))completionHandler;
- (NSURLSessionDownloadTask *)downloadTaskWithURL:(NSURL *)url completionHandler:(void (^)(NSURL *location, NSURLResponse *response, NSError *error))completionHandler;
- (NSURLSessionDownloadTask *)downloadTaskWithResumeData:(NSData *)resumeData completionHandler:(void (^)(NSURL *location, NSURLResponse *response, NSError *error))completionHandler;
关于断点续传,使用到的其他方法如下(断点续传的前提是服务器也支持断点续传):
// 使用这种方式取消下载可以得到将来用来恢复的数据,保存起来
[self.task cancelByProducingResumeData:^(NSData *resumeData) {
self.resumeData = resumeData;
}];
// 由于下载失败导致的下载中断会进入此协议方法,也可以得到用来恢复的数据
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
// 保存恢复数据
self.resumeData = error.userInfo[NSURLSessionDownloadTaskResumeData];
}
// 恢复下载时接过保存的恢复数据
self.task = [self.session downloadTaskWithResumeData:self.resumeData];
// 启动任务
[self.task resume];
我们举个例子来认识一下普通下载过程(代理方式,需要遵守NSURLSessionDelegate,NSURLSessionDownloadDelegate):
- (void)downloadRequest{
//创建请求
NSMutableURLRequest * request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"http://httpbin.org/image/jpeg"]];
//创建配置(决定要不要将数据和响应缓存在磁盘)
NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration];
//创建会话
NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil];
NSURLSessionDownloadTask * downloadtask = [session downloadTaskWithRequest:request];
[downloadtask resume];
}
//1. downloadTask下载过程中会执行
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite{
NSLog(@"下载中...");
NSLog(@"写入数据大小%lld,总写入数据大小%lld,总期望数据大小%lld",bytesWritten,totalBytesWritten,totalBytesExpectedToWrite);
//监听下载的进度
}
//2.downloadTask下载完成的时候会执行
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location{
NSLog(@"下载完成");
//该方法内部已经完成了边接收数据边写沙盒的操作,解决了内存飙升的问题
//对数据进行使用,或者保存(默认存储到临时文件夹 tmp 中,需要剪切文件到 cache)
//保存
NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
[[NSFileManager defaultManager] moveItemAtURL:location toURL:[NSURL fileURLWithPath:filePath] error:nil];
//使用
NSData * data = [NSData dataWithContentsOfURL:location.filePathURL];
UIImage * image = [UIImage imageWithData:data];
UIImageWriteToSavedPhotosAlbum(image, nil,nil,nil);
}
//3.请求完成或者是失败的时候调用(Session层次的Task完成的事件)
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task
didCompleteWithError:(nullable NSError *)error{
NSLog(@"请求完成或者是失败");
}
如果想了解一下后台下载,可以看下这篇文章iOS7 Networking with NSURLSession。
网友评论