URL加载系统之二:NSURLSession

NSURLSession及相关的类提供通过HTTP协议下载数据的API。该类提供了大量代理方法来支持认证和后台下载(程序未运行或挂起时)功能。

为了使用NSURLSession,我们的应用会创建一系列的会话,每个会话负责协调一组相关数据的传输任务。在每个会话中,我们的应用添加一系列的任务,每个任务都表示一个对指定URL的请求。与大多数网络API一样,NSURLSession API是异步的。如果我们使用系统提供的代理,我们必须提供一个请求完成处理block,以便在请求成功或失败时返回数据给我们的应用。如果我们提供自定义的代理对象,则任务对象调用这些代理方法,并回传从服务端获取的数据(如果是文件下载,则当传输完成时调用)。

NSURLSession提供了status和progress属性,并作为额外的信息传递给代理。同时它支持取消、恢复、挂起操作,并支持断点续传功能。

要掌握NSURLSession的使用,我们需要了解下URL会话的一些内容

URL会话

在一个会话中的任务的行为取决于三个方面:

session的类型(由创建会话时的配置对象确定)

任务的类型

当任务创建时应用是否在前台

NSURLSession支持以下三种会话类型:

默认会话:行为与其它下载URL的Foundation方法类似。使用基于磁盘的缓存策略,并在用户keychain中存储证书。

短暂会话(Ephemeral sessions):不存储任何数据在磁盘中;所有的缓存,证书存储等都保存在RAM中并与会话绑定。这样,当应用结束会话时,它们被自动释放。

后台会话(Background sessions):类似于默认会话,除了有一个独立的进程来处理所有的数据传输。

在一个会话中,NSURLSession支持三种任务类型

数据任务:使用NSData对象来发送和接收数据。数据任务可以分片返回数据,也可以通过完成处理器一次性返回数据。由于数据任务不存储数据到文件,所以不支持后台会话.

下载任务:以文件的形式接收数据,当程序不运行时支持后台下载

上传任务:通常以文件的形式发送数据,支持后台上传。

NSURLSession支持在程序挂起时在后台传输数据。后台传输只由使用后台会话配置对象创建的会话提供。使用后台会话时,由于实际传输是在一个独立的进程中传输,且重启应用进程相当损耗资源,只有少量特性可以使用,所以有以下限制:

会话必须提供事件分发的代理。

只支持HTTP和HTTPS协议

只支持上传和下载任务

总是伴随着重定义操作

如果当应用在后台时初始化的后台传输,则配置对象的discretionary属性为true

在iOS中,当我们的应用不再运行时,如果后台下载任务完成或者需要证书,则系统会在后台自动重启我们的应用,同时调用UIApplicationDelegate对象的application:handlerEventsForBackgroundURLSession:completionHandler:方法。这个调用会提供启动的应用的session的标识。我们的应用应该存储完成处理器,使用相同的标识来创建后台配置对象,然后使用配置对象来创建会话。新的会话会与运行的后台activity关联。当会话完成后台下载任务时,会给会话代理发送一个URLSessioinDidFinishEventsForBackgroundURLSession:消息。我们的代理对象然后调用存储的完成处理器。

如果在程序挂起时有任何任务完成,则会调用URLSession:downloadTask:didFinishDownloadingToURL:方法。同样的,如果任务需要证书,则NSURLSession对象会在适当的时候调用URLSession:task:didReceiveChallenge:completionHandler: 和URLSession:didReceiveChallenge:completionHandler:方法。

这里需要注意的是必须为每个标识创建一个会话,共享相同标识的多个会话的行为是未定义的。

会话和任务对象实现了NSCopying协议:

当应用拷贝一个会话或任务对象时,会获取相同对象的指针

当应用拷贝一个配置对象时,会获取一个可单独修改的新的对象

创建并配置NSURLSession

我们下面举个简单的实例来说明一个NSURLSession与服务端的数据交互。

代码清单1:声明三种类型会话对象

@interface URLSession : NSObject

@property (nonatomic, strong) NSURLSession *backgroundSession;

@property (nonatomic, strong) NSURLSession *defaultSession;

@property (nonatomic, strong) NSURLSession *ephemeralSession;

@property (nonatomic, strong) NSMutableDictionary *completionHandlerDictionary;

- (void)addCompletionHandler:(CompletionHandlerType)handler forSession:(NSString *)identifier;

- (void)callCompletionHandlerForSession:(NSString *)identifier;

@end


NSURLSession提供了大量的配置选项,包括:

支持缓存、cookie,认证及协议的私有存储

认证

上传下载文件

每个主机的配置最大数

超时时间

支持的TLS最小最小版本

自定义代理字典

控制cookie策略

控制HTTP管道行为

由于大部分设置都包含在一个独立的配置对象中,所以我们可以重用这些配置。当我们初始一个会话对象时,我们指定了如下内容

一个配置对象,用于管理其中的会话和任务的行为

一个代理对象,用于在收到数据时处理输入数据,及会话和任务中的其它事件,如服务端认证、确定一个资源加载请求是否应该转换成下载等。这个对象是可选的。但如果我们需要执行后台传输,则必须提供自定义代理。

在实例一个会话对象后,我们不能改变改变配置或代理。

代码清单2演示了如何创建一个会话

NSURLSessionConfiguration *defaultConfigObject = [NSURLSessionConfiguration defaultSessionConfiguration];

// 配置会话的缓存

NSString *cachePath = @"/MyCacheDirectory";

NSArray *pathList = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);

NSString *path = [pathList objectAtIndex:0];

NSString *bundleIdentifier = [[NSBundle mainBundle] bundleIdentifier];

NSString *fullCachePath = [[path stringByAppendingPathComponent:bundleIdentifier] stringByAppendingPathComponent:cachePath];

NSLog(@"Cache path: %@", fullCachePath);

NSURLCache *cache = [[NSURLCache alloc] initWithMemoryCapacity:16384 diskCapacity:268435456 diskPath:cachePath];

defaultConfigObject.URLCache = cache;

defaultConfigObject.requestCachePolicy = NSURLRequestUseProtocolCachePolicy;

self.defaultSession = [NSURLSession sessionWithConfiguration:defaultConfigObject delegate:self delegateQueue:[NSOperationQueue mainQueue]];

除了后台配置对象外,我们可以重用会话的配置对象来创建新的会话,正如上面所讲的,拷贝一个配置对象会生成一个新的独立的配置对象。我们可以在任何时候安全的修改配置对象。当创建一个会话时,会话会对配置对象进行深拷贝,所以修改只会影响到新的会话。代理清单3演示了创建一个新的会话,这个会话使用重用的配置对象。

代码清单3:重用会话对象

self.ephemeralSession = [NSURLSession sessionWithConfiguration:ephemeralConfigObject delegate:self delegateQueue:[NSOperationQueue mainQueue]];

ephemeralConfigObject.allowsCellularAccess = YES;

// ...

NSURLSession *ephemeralSessionWifiOnly = [NSURLSession sessionWithConfiguration:ephemeralConfigObject delegate:self delegateQueue:[NSOperationQueue mainQueue]];

使用NSURLSession获取数据基本就是两步:

创建一个配置对象及基于这个对象的会话

定义一个请求完成处理器来处理获取到的数据。

如果使用系统提供的代理,只需要代码清单4这几行代码即可搞定

代码清单4:使用系统提供代理

NSURLSession *delegateFreeSession = [NSURLSession sessionWithConfiguration:defaultConfigObject delegate:self delegateQueue:[NSOperationQueue mainQueue]];

[delegateFreeSession dataTaskWithRequest:@"http://www.sina.com"

completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {

NSLog(@"Got response %@", response);

}];

只是系统提供的代理只提供有限的网络行为。如果应用需要更多的处理,如自定义认证或后台下载等,则需要使用自定义的代理。使用自定义代理来获取数据时,代理必须实现以下方法:

URLSession:dataTask:didReceiveData: 从请求提供数据给我们的任务,一次一个数据块

URLSession:task:didCompleteWithError: 表示任务已经接受了所有的数据。

如果我们在URLSession:dataTask:didReceiveData:方法返回后使用数据,则需要将数据存储在某个地方。

代码清单5:演示了一个数据访问实例:

NSURL *url = [NSURL URLWithString:@"http://www.sina.com"];

NSURLSessionDataTask *dataTask = [self.defaultSession dataTaskWithURL:url];

[dataTask resume];

如果远程服务器返回的状态表示需要一个认证,且认证需要连接级别的处理时,NSURLSession将调用认证相关代理方法。这个具体我们后面文章将详细讨论。

处理iOS后台Activity

在iOS中使用NSURLSession时,当一个下载完成时,会自动启动我们的应用。应用的代理方法application:handleEventsForBackgroundURLSession:completionHandler: 负责创建一个合适的会话,存储请求完成处理器,并在会话调用会话代理的URLSessionDidFinishEventsForBackgroundURLSession: 方法时调用这个处理器。代码清单6与代码清单7演示了这个处理流程

代码清单6:iOS后台下载的会话代理方法

- (void)URLSessionDidFinishEventsForBackgroundURLSession:(NSURLSession *)session

{

NSLog(@"background url session %@", session);

if (session.configuration.identifier)

{

[self callCompletionHandlerForSession:session.configuration.identifier];

}

}

- (void)callCompletionHandlerForSession:(NSString *)identifier

{

CompletionHandlerType handler = [self.completionHandlerDictionary objectForKey:identifier];

if (handler) {

[self.completionHandlerDictionary removeObjectForKey:identifier];

handler();

}

}

代码清单7:iOS后台下载的App 代理方法

- (void)application:(UIApplication *)application handleEventsForBackgroundURLSession:(NSString *)identifier completionHandler:(void (^)())completionHandler

{

NSURLSessionConfiguration *backgroundConfigObject = [NSURLSessionConfiguration backgroundSessionConfiguration:identifier];

URLSession *sessionDelegate = [[URLSession alloc] init];

NSURLSession *backgroundSession = [NSURLSession sessionWithConfiguration:backgroundConfigObject

delegate:sessionDelegate

delegateQueue:[NSOperationQueue mainQueue]];

[sessionDelegate addCompletionHandler:completionHandler forSession:identifier];

}

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,295评论 6 512
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,928评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,682评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,209评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,237评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,965评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,586评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,487评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,016评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,136评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,271评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,948评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,619评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,139评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,252评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,598评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,267评论 2 358

推荐阅读更多精彩内容