iOS NSURLSession使用

NSURLSessionTask

　　NSURLSessionTask是一个抽象子类，它有三个具体的子类是可以直接使用的：NSURLSessionDataTask，NSURLSessionUploadTask和NSURLSessionDownloadTask。这三个类封装了现代应用程序的三个基本网络任务：获取数据，比如JSON或XML，以及上传下载文件。

　　

　　当一个NSURLSessionDataTask完成时，它具有关联的数据，而一个NSURLSessionDownloadTask完成时，它具有一个已下载文件的临时文件路径。 NSURLSessionUploadTask 继承了 NSURLSessionDataTask，因为服务器响应一个上传请求时，往往伴随着相关联的数据。 ???所有任务均可撤销，也可以暂停和恢复。当一个下载任务被取消时，它可以选择创建恢复数据，然后可以传递给下一次新创建的下载任务，以便继续之前的下载。

　　不同于直接使用alloc-init‘d初始化方法，任务是由一个NSURLSession创建的。每个任务的构造方法都对应一个版本，有或者没有completionHandler属性，例如：–dataTaskWithRequest: 和–dataTaskWithRequest:completionHandler:。这与NSURLConnection的 -sendAsynchronousRequest:queue:completionHandler:类似，通过指定completionHandler属性创建并使用一个隐含的委托，而不是使用任务的会话。在任何一种任务会话委托的默认行为需要被重写的情况下，这种不太方便的非completionHandler的变体将需要被使用。

Constructors

　　iOS5中，NSURLConnection添加了sendAsynchronousRequest:queue:completionHandler:方法，这大大简化了一次性请求的使用，同时可以作为sendSynchronousRequest:returningResponse:error::的异步替代品。

 NSURL *URL = [NSURL URLWithString:@"http://example.com"];
 NSURLRequest *request = [NSURLRequest requestWithURL:URL];

 [NSURLConnection sendAsynchronousRequest:request
                                    queue:[NSOperationQueue mainQueue]
                        completionHandler:^(NSURLResponse *response, NSData *data, NSError *error) {
     // ...
 }];

　　NSURLSession与它的任务构造方法在此模式上迭代。在执行resume方法前，该任务对象为了进行进一步的配置而返回，而不是立即执行resume方法。

　　数据任务可以通过NSURL或NSURLRequest创建（前者是一个标准GET请求URL的快捷方式）。

 NSURL *URL = [NSURL URLWithString:@"http://example.com"];
 NSURLRequest *request = [NSURLRequest requestWithURL:URL];

 NSURLSession *session = [NSURLSession sharedSession];
 NSURLSessionDataTask *task = [session dataTaskWithRequest:request
                                         completionHandler:
     ^(NSData *data, NSURLResponse *response, NSError *error) {
         // ...
     }];

 [task resume];

　　上传任务也可以通过一个请求以及一个需要上传的本地文件的URL对应的NSData对象创建。

NSURL *URL = [NSURL URLWithString:@"http://example.com/upload"];
 NSURLRequest *request = [NSURLRequest requestWithURL:URL];
 NSData *data = ...;

 NSURLSession *session = [NSURLSession sharedSession];
 NSURLSessionUploadTask *uploadTask = [session uploadTaskWithRequest:request
                                                            fromData:data
                                                   completionHandler:
     ^(NSData *data, NSURLResponse *response, NSError *error) {
         // ...
     }];

 [uploadTask resume];

　　下载任务也需要一个请求，但不同之处在于它们的completionHandler。数据和上传任务在完成时立即返回，但下载任务将数据写入本地的临时文件。completionHandler有责任将文件从它的临时位置移动到一个永久位置，这个永久位置就是块的返回值。

NSURL *URL = [NSURL URLWithString:@"http://example.com/file.zip"];
 NSURLRequest *request = [NSURLRequest requestWithURL:URL];

 NSURLSession *session = [NSURLSession sharedSession];
 NSURLSessionDownloadTask *downloadTask = [session downloadTaskWithRequest:request
                                                         completionHandler:
    ^(NSURL *location, NSURLResponse *response, NSError *error) {
        NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
        NSURL *documentsDirectoryURL = [NSURL fileURLWithPath:documentsPath];
        return [documentsDirectoryURL URLByAppendingPathComponent:[[response URL] lastPathComponent]];
    }];

 [downloadTask resume];

NSURLSession & NSURLConnection Delegate Methods

　　总体而言，NSURLSession的委托方法，是NSURLConnection的演化的十年中 ad-hoc 模式出现以来的一个显著改善。对于一个完整的概述，可以查看此映射表。

　　以下是一些具体的观察：

　　NSURLSession同时具有用来处理身份验证挑战会话和任务委托方法。这个会话的委托方法处理连接级别的问题，如服务器信任和客户端证书的评估，NTLM和Kerberos，而任务的委托处理以请求为基础的挑战，如Basic, Digest, 或者代理身份验证。

　　NSURLConnection由两个方法可以表明一个请求已经完成(NSURLConnectionDataDelegate -connectionDidFinishLoading: 和 NSURLConnectionDelegate -connection:didFailWithError:)，而NSURLSession只有一个委托方法(NSURLSessionTaskDelegate -URLSession:task:didCompleteWithError:)。

　　与NSURLConnection使用的 long long类型相比，委托方法指定在NSURLSession中一定数量的字节传输使用int64_t类型的参数。

　　NSURLSession在Foundation框架对于委托方法的completionHandler:参数使用上 ，引入了一种新的模式。这允许委托方法可以安全地在主线程以非阻塞方式运行；委托可以简单地在后台运行dispatch_async ，然后在完成时调用completionHandler。同时，它可以有效地拥有多个返回值，不需要使用笨拙的参数指针。就NSURLSessionTaskDelegate的URLSession:task:didReceiveChallenge:completionHandler:方法而言，completionHandler接受两个参数：身份验证质询的处理（ the authentication challenge disposition）以及需用使用的证书（如果适用）。

　　想要查看更多关于会话任务的信息，可以查看 WWDC Session 705: “What’s New in Foundation Networking”

NSURLSessionConfiguration

　　NSURLSessionConfiguration对象用于初始化NSURLSession对象。展开请求级别中与NSMutableURLRequest相关的可供选择的方案，我们可以看到NSURLSessionConfiguration对于会话如何产生请求，提供了相当多的控制和灵活性。从网络访问性能，到cookie，安全性，缓存策略，自定义协议，启动事件设置，以及用于移动设备优化的几个新属性，你会发现你一直在寻找的，正是NSURLSessionConfiguration。

　　会话在初始化时复制它们的配置，NSURLSession有一个只读的配置属性，使得该配置对象上的变化对这个会话的政策无效。配置在初始化时被读取一次，之后都是不会变化的。

Constructors

　　NSURLSessionConfiguration有三个类构造函数，这很好地说明了NSURLSession是为不同的用例而设计的。

　　+ defaultSessionConfiguration返回标准配置，这实际上与NSURLConnection的网络协议栈是一样的，具有相同的共享NSHTTPCookieStorage，共享NSURLCache和共享NSURLCredentialStorage。

　　+ ephemeralSessionConfiguration返回一个预设配置，没有持久性存储的缓存，Cookie或证书。这对于实现像秘密浏览功能的功能来说，是很理想的。

　　+ backgroundSessionConfiguration：独特之处在于，它会创建一个后台会话。后台会话不同于常规的，普通的会话，它甚至可以在应用程序挂起，退出，崩溃的情况下运行上传和下载任务。初始化时指定的标识符，被用于向任何可能在进程外恢复后台传输的守护进程提供上下文。

　　想要查看更多关于后台会话的信息，可以查看WWDC Session 204: “What’s New with Multitasking”

Properties

　　NSURLSessionConfiguration拥有20个属性。熟练掌握这些属性的用处，将使应用程序充分利用其网络环境。

General

　　HTTPAdditionalHeaders指定了一组默认的可以设置出站请求的数据头。这对于跨会话共享信息，如内容类型，语言，用户代理，身份认证，是很有用的。

NSString *userPasswordString = [NSString stringWithFormat:@"%@:%@", user, password];
NSData * userPasswordData = [userPasswordString dataUsingEncoding:NSUTF8StringEncoding];
NSString *base64EncodedCredential = [userPasswordData base64EncodedStringWithOptions:0];
NSString *authString = [NSString stringWithFormat:@"Basic: %@", base64EncodedCredential];
NSString *userAgentString = @"AppName/com.example.app (iPhone 5s; iOS 7.0.2; Scale/2.0)";

configuration.HTTPAdditionalHeaders = @{@"Accept": @"application/json",
                                        @"Accept-Language": @"en",
                                        @"Authorization": authString,
                                        @"User-Agent": userAgentString};

　　networkServiceType对标准的网络流量，网络电话，语音，视频，以及由一个后台进程使用的流量进行了区分。大多数应用程序都不需要设置这个。