NSURLSession 教程

96
i红人
2015.01.11 17:26* 字数 2127

为什么要使用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有关的,就不再翻译了。

转载请注明出处。

ios
Web note ad 1