NSURLSession 教程

为什么要使用NSURLSession?

翻译原文 ,所有版权规其所有。

well,先来看一些优点:

  • 后台上传和下载:只需在创建NSURLSession的时候配置一个选项,就能得到后台网络的所有好处。这样可以延长电池寿命,并且还支持UIKit的多task,在进程间使用相同的委托模型。

  • 能够暂停和恢复网络操作:使用NSURLSession API能够暂停,停止,恢复所有的网络任务,再也完全不需要子类化NSOperation.

  • 可配置的容器:对于NSURLSession里面的requests来说,每个NSURLSession都是可配置的容器。举个例来说,假如你需要设置HTTP header选项,你只用做一次,session里面的每个request就会有同样的配置。

  • 提高认证处理:认证是在一个指定的连接基础上完成的。在使用NSURLConnection时,如果发出一个访问,会返回一个任意的request。此时,你就不能确切的知道哪个request收到了访问。而在NSURLSession中,就能用代理处理认证。

  • 丰富的代理模式:在处理认证的时候,NSURLConnection有一些基于异步的block方法,但是它的代理方法就不能处理认证,不管请求是成功或是失败。在NSURLSession中,可以混合使用代理和block方法处理认证。

  • 上传和下载通过文件系统:它鼓励将数据(文件内容)从元数据(URL和settings)中分离出来。

NSURLSession vs NSURLConnection

“哇喔,看起来NSURLSession好复杂!”,你可能会这样想。“还是坚持用NSURLConnection吧。”

别担心 — 使用NSURLSession处理简单task就如使用NSURLConnection一样容易。例如,我们使用一个简单的网络调用,来得到伦敦最新天气的JSON数据。

假设你有这样一个URL字符串:

NSString *londonWeatherUrl = @"http://api.openweathermap.org/data/2.5/weather?q=London,uk" ;

首先,使用NSURLConnection会这么做:

NSURLRequest *request = [NSURLRequest requestWithURL:
[NSURL URLWithString:londonWeatherUrl]];
[NSURLConnection sendAsynchronousRequest:request queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse *response,
                   NSData *data,
                   NSError *connectionError) {
  // handle response
  }];  

那来看下NSURLSession是怎么做的。这个是NSURLSession使用的最简单方法。随后你还会看到怎样配置session,设置其他的特性,比如代理。

NSURLSession *session = [NSURLSession sharedSession];
[[session dataTaskWithURL:[NSURL URLWithString:londonWeatherUrl]
      completionHandler:^(NSData *data,
                          NSURLResponse *response,
                          NSError *error) {
        // handle response
}] resume];  

注意,你不需要指定运行哪个队列,默认会开辟一个后台线程。如果有两个的话,这种设计可能就比较难区分之间的不同。苹果官方旨在使用dataTaskWithURL来代替NSURLConnection中的sendAsynchronousRequest

看吧,NSURLSession就如NSURLConnection一样易用,并且还有一些额外的功能。


NSURLSession vs AFNetworking

说到网络请求不得不说的就是AFNetworking Framework。这是iOS/OS X上最流行的框架之一,由Mattt Thompson创建。
<pre>
<b>注意</b>:学习AFNetworking,可以在github页面上找到,<a harf="https://github.com/AFNetworking/AFNetworking">https://github.com/AFNetworking/AFNetworking</a>,你还可以看这篇教程<a harf="http://www.raywenderlich.com/30445/afnetworking-crash-course">http://www.raywenderlich.com/30445/afnetworking-crash-course</a>
</pre>

下面是对于同样的数据请求,AFNetworking 1.x的代码:

NSURLRequest *request = [NSURLRequest requestWithURL:
                     [NSURL URLWithString:londonWeatherUrl]];

AFJSONRequestOperation *operation =
[AFJSONRequestOperation JSONRequestOperationWithRequest:request
success:^(NSURLRequest *request,
          NSHTTPURLResponse *response,
          id JSON) {
// handle response
} failure:nil];
[operation start];  

使用AFNetworking的好处之一是,它的处理响应数据是数据类型类,AFJSONRequestOperation(或类似XML,plist)的返回成功的block里面已经解析出了你要的数据。而NSURLSession接收到的是NSData类型,你需要把它再转换成JSON类型。

<pre>
<b>注意:</b>用NSJSONSerialization可以轻松的将NSData类型转换为JSON类型。
</pre>

那么,你是喜欢用AFNetworking还是NSURLSession呢?
个人认为,简单的需求最好用NSURlSession-这可减少工程里面第三方库的依赖。当然了,现在AFNetworking也添加了新的代理,配置,基于task的API等等特性。

如果你使用了AFNetworking2.0的新特性,比如系列化,并且还集成了UIKit(加入了一些UIImageView的类目方法),现在就很难说服你不用它了。

<pre>
<b>注意:</b>在AFNetworking2.0的分支,他们已经转成使用NSURLSession。
<a harf="https://github.com/AFNetworking/AFNetworking/wiki/AFNetworking-2.0-Migration-Guide">https://github.com/AFNetworking/AFNetworking/wiki/AFNetworking-2.0-Migration-Guide</a>
</pre>

译者注:中间这里有一部分讲到了Dropbox,这里就不翻译了。对于Dropbox,国内墙得厉害,完全打不开。

NSURLSession 类套(suite of classes)

苹果公司描述了新类NSURLSession,及其类套。包括新的上传,下载,处理认证等工具,能处理http协议中的所用事情。

在编码前,重要的先理解它们是怎样协同工作的。

NSurLSessionNSuRLSessionConfiguration和可选代理(optional delegate)构成。再根据你的网络需求通过NSURLSessionTask来创建session。


NSURLSessionConfiguration

有三个方法用来创建NSURLSessionConfiguration:

  • defaultSessionConfiguration- 使用全局的cache,cookie和credential storage objects来创建configuration对象。

  • ephemeralSessionConfiguration – 这个configuration用于“private” sessions,还有对于cache, cookie, or credential storage objects的非永久存储。

  • backgroundSessionConfiguration – 做远程push通知或是应用程序挂起的时候就要用到这个configuration。

一旦创建了NSURLSessionConfiguration就可以给它设置各种属性:

NSURLSessionConfiguration *sessionConfig =
[NSURLSessionConfiguration defaultSessionConfiguration];

// 1
sessionConfig.allowsCellularAccess = NO;

// 2
[sessionConfig setHTTPAdditionalHeaders:
      @{@"Accept": @"application/json"}];

// 3
sessionConfig.timeoutIntervalForRequest = 30.0;
sessionConfig.timeoutIntervalForResource = 60.0;
sessionConfig.HTTPMaximumConnectionsPerHost = 1;
  1. 限制了网络只能是wifi。
  2. 设置了所有的请求只接收JSON数据
  3. 配置网络超时,限制一个主机只有一个网络连接。

这里仅仅只做了一些简单的配置,看文档去了解更多的属性吧。


NSURLSession

NSURLSession是为了代替NSURLConnection而设计的。Sessions的所有工作都是通过它的小弟,也就是NSURLSessionTask的对象。可以用block,delegate,或者两者混合来创建task。举个例子,你要下载图片,就要创建NSURLSessionDownloadTask

首先需要创建session:

// 1
NSString *imageUrl =
@"http://www.raywenderlich.com/images/store/    iOS7_PDFonly_280@2x_authorTBA.png";

// 2
NSURLSessionConfiguration *sessionConfig =[NSURLSessionConfiguration defaultSessionConfiguration];

// 3
NSURLSession *session =[NSURLSession sessionWithConfiguration:sessionConfig
                            delegate:self
                       delegateQueue:nil];

ok,这个看上去和前面的只有点不同,一步一步看:

  1. 这里下载一张图片(译者改:原文匪夷所思)。
  2. 创建NSURLConfiguration
  3. 用当前类对象作为代理创建session。

之后,通过创建带有完成处理的task来下载图片:

// 1
NSURLSessionDownloadTask *getImageTask =
[session downloadTaskWithURL:[NSURL URLWithString:imageUrl]

completionHandler:^(NSURL *location,
                    NSURLResponse *response,
                    NSError *error) {
// 2
UIImage *downloadedImage =
      [UIImage imageWithData:
          [NSData dataWithContentsOfURL:location]];
//3
dispatch_async(dispatch_get_main_queue(), ^{
    // do stuff with image
    _imageWithBlock.image = downloadedImage;
  });
  }];

// 4
[getImageTask resume];  

很好,现在看起来像网络请求代码了!

  1. task由session创建。上面是创建了一个基于block的方法。你还可以用NSURLSessionDownloadDelegate跟踪下载进度:

     -URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:  
    
  2. 通过location变量来得到image指针。

  3. 然后是更新UIImageView的图片。

  4. 开始这个task。

  5. session能够轻松的创建task,并发送到代理方法,通知你完成。

这是像上面使用相同的session:

// 1
NSURLSessionDownloadTask *getImageTask = [session downloadTaskWithURL:[NSURL URLWithString:imageUrl]];

[getImageTask resume];  
  1. 如果你接下来什么都不做的话,我们就使用这些代码。那么,就需要实现这个协议中的代理方法NSURLSessionDownloadDelegate。首先是,收到下载完成的通知:

     -(void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location { 
     // use code above from completion handler 
     }  
    

这里再一次给你提供了location,然后用它就能获取image。

最后,如果需要跟踪下载进度:

-(void)URLSession:(NSURLSession *)session
     downloadTask:(NSURLSessionDownloadTask *)downloadTask
     didWriteData:(int64_t)bytesWritten
totalBytesWritten:(int64_t)totalBytesWritten
totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
  NSLog(@"%f / %f", (double)totalBytesWritten,
(double)totalBytesExpectedToWrite);
}  


NSURLSessionTask

上面看了NSURLSessionDataTaskNSURLSessionDownloadTask的使用。这两个都是继承至NSURLSessionTask

NSURLSessionTask是session中task的基类,它们只能由session或session的子类创建。

NSURLSessionDataTask

这个task调用HTTP GET请求从服务器获取数据。返回的数据格式是NSData。可能需要你自己转换成XML,JSON,UIimage等..

NSURLSessionDataTask *jsonData = [session dataTaskWithURL:yourNSURL
  completionHandler:^(NSData *data,
                      NSURLResponse *response,
                      NSError *error) {
    // handle NSData
}];  

NSURLSessionUploadTask

这个类是上传用的,在数据传输过程中,这个代理方法能观察网络状况。
上传一张图片:

NSData *imageData = UIImageJPEGRepresentation(image, 0.6);

NSURLSessionUploadTask *uploadTask = [upLoadSession uploadTaskWithRequest:request fromData:imageData];

这个task由session创建,上传图片的NSData。其他上传方法还有上传文件,或是数据流。

NSURLSessionDownloadTask

NSURLSessionDownloadTask下载文件更简单,可以在下载中挂起,恢复。它有一点点不同于其他两个子类。

  1. task的类型直接写到一个临时文件中。
  2. 下载过程中会调用URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite: 去更新状态。
  3. 当task完成,URLSession:downloadTask:didFinishDownloadingToURL:会被调用。此时你可以将临时文件保存到永久文件中。
  4. 下载失败或是取消还可以得到已经下载的那一部分数据。

使用这个挂起task:

//[uploadTask resume];  
[uploadTask suspend];  

同时管理多个task时,可以用taskIdentifier属性来唯一标识task。

well,现在了解了NSURLSession类套中主要的类。

后面还有一部分,还是与Dropbox有关的,就不再翻译了。

转载请注明出处。

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

推荐阅读更多精彩内容

  • 在苹果彻底弃用NSURLConnection之后自己总结的一个网上的内容,加上自己写的小Demo,很多都是借鉴网络...
    付寒宇阅读 4,244评论 2 13
  • NSURLSession概述1. NSURLSession session类型NSURLSession包括下面3种...
    瞎嘚嘚阅读 1,864评论 2 2
  • iOS开发系列--网络开发 概览 大部分应用程序都或多或少会牵扯到网络开发,例如说新浪微博、微信等,这些应用本身可...
    lichengjin阅读 3,626评论 2 7
  • NSURLSession 使用步骤使用NSURLSession对象创建Task,然后执行Task -(void)g...
    BEYOND黄阅读 892评论 0 0
  • 8月21日是开学的第一天。我认识了许多的朋友,共有六个。然后组长带着我们上楼吃了饭,我是第一次上楼吃饭呢!吃完饭,...
    刘璐琳阅读 221评论 1 1