NSURLSession的学习和使用

本文转载自：http://blog.csdn.net/chenpolu/article/details/42566073

为什么要使用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创建。

注意：学习AFNetworking，可以在github页面上找到,https://github.com/AFNetworking/AFNetworking,你还可以看这篇教程http://www.raywenderlich.com/30445/afnetworking-crash-course

下面是对于同样的数据请求，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类型。

注意：用NSJSONSerialization可以轻松的将NSData类型转换为JSON类型。

那么，你是喜欢用AFNetworking还是NSURLSession呢？

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

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

注意：在AFNetworking2.0的分支，他们已经转成使用NSURLSession。 https://github.com/AFNetworking/AFNetworking/wiki/AFNetworking-2.0-Migration-Guide

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

NSURLSession 类套（suite of classes）

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

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



NSurLSession由NSuRLSessionConfiguration和可选代理(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;

限制了网络只能是wifi。
设置了所有的请求只接收JSON数据
配置网络超时，限制一个主机只有一个网络连接。

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

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,这个看上去和前面的只有点不同，一步一步看:
这里下载一张图片(译者改：原文匪夷所思)。
创建NSURLConfiguration。
用当前类对象作为代理创建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];

很好，现在看起来像网络请求代码了！

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

-URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:

通过location变量来得到image指针。

然后是更新UIImageView的图片。
开始这个task。
session能够轻松的创建task，并发送到代理方法，通知你完成。

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

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

[getImageTask resume];

如果你接下来什么都不做的话，我们就使用这些代码。那么，就需要实现这个协议中的代理方法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


上面看了NSURLSessionDataTask和NSURLSessionDownloadTask的使用。这两个都是继承至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下载文件更简单，可以在下载中挂起，恢复。它有一点点不同于其他两个子类。
task的类型直接写到一个临时文件中。
下载过程中会调用

URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:

 去更新状态。
当task完成，

URLSession:downloadTask:didFinishDownloadingToURL:

会被调用。此时你可以将临时文件保存到永久文件中。
下载失败或是取消还可以得到已经下载的那一部分数据。

使用这个挂起task：

[uploadTask resume];

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

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

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