NSURLSession

NSURLSession是iOS7中新的网络接口，与NSURLConnection是并列的。
当程序在前台时，NSURLSession与NSURLConnection大部分可以互相替代
NSURLSession支持后台网络操作，除非用户强行关闭

NSURLSession提供的功能：
通过URL将数据下载到内存
通过URL将数据下载到文件系统
将数据上传到指定URL
在后台完成上述功能

对于小型数据，例如用户登录、下载小图像、JSON & XML仍然使用NSURLConnection的异步或同步方法即可

NSURLSession中用到的类
1>NSURLSessionConfiguratio
作用：用于定义和配置NSURLSession对象
每一个NSURLSession对象都可以设置不同的NSURLSessionConfiguration，从而满足应用内不同类型的网络请求

NSURLSessionConfiguration的三种类型：
defaultSessionConfiguration默认session配置，类似NSURLConnection的标准配置，使用硬盘来存储缓存数据
ephemeralSessionConfiguration临时session配置，与默认配置相比，这个配置不会将缓存、cookie等存在本地，只会存在内存里，所以当程序退出时，所有的数据都会消失
backgroundSessionConfiguration后台session配置，与默认配置类似，不同的是会在后台开启另一个线程来处理网络数据

2>NSURLSession
使用NSURLSessionConfiguration来配置NSURLSession对象
用NSURLSession对象来启动一个NSURLSessionTask对象

提示：
可以使用系统全局的sharedSession单例来满足大多数的需求
相比较NSURLConnection的返回处理，NSURLSession提供了灵活的数据返回方式，可以使用简单的block方式来处理返回数据，也可以使用更强大的delegate
URLSession是线程安全的，在多线程方面的支持也比URLConnection要好


3>NSURLSessionTask
NSURLSession使用NSURLSessionTask来具体执行网络请求的任务

NSURLSessionTask支持网络请求的取消、暂停和恢复，比如下载文件暂停之后再恢复就能够自动从上次的进度继续下载
NSURLSessionTask还能获取数据的读取进度

NSURLSessionTask的三种类型：
NSURLSessionDataTask 处理一般的NSData数据对象，比如通过GET或POST方式从服务器获取JSON或XML返回等等，但不支持后台获取（传统的 GET / POST 方法，包括 POST 上传文件）
NSURLSessionUploadTask 用于PUT上传文件，支持后台上传（上传任务 - PUT 方式的文件上传）
NSURLSessionDownloadTask 用于下载文件，支持后台下载文件，支持后台下载

/*****多线程下载实例****/
@interface ViewController () <NSURLSessionDownloadDelegate>
@property (weak, nonatomic) IBOutlet HMDownloadButton *progressButton;

@property (nonatomic, strong) NSURLSession *session;
// 下载任务
@property (nonatomic, strong) NSURLSessionDownloadTask *downloadTask;
// 续传数据
@property (nonatomic, strong) NSData *resumeData;
@end

@implementation ViewController

- (NSURLSession *)session {
    if (_session == nil) {
        NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
        
        _session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil];
    }
    return _session;
}

// 开始
- (IBAction)start {
    NSString *urlString = @"http://download.ime.sogou.com/1411725208/sogou_mac_30a.dmg?st=iPW0jnPMdGHl-Or5UhcbAw&e=1416824560&fn=sogou_mac_30a.dmg";
    urlString = [urlString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    
    NSURL *url = [NSURL URLWithString:urlString];
    
    // 在 NSURLConnection中是在代理方法中计算下载进度，NSURLSession同样是通过代理
    self.downloadTask = [self.session downloadTaskWithURL:url];
    
    // 任务默认是挂起的，别忘了继续
    [self.downloadTask resume];
}

// 暂停－下载任务
- (IBAction)pause {
    // 暂停下载任务，如果再次暂停，因为downloadTask没有工作，所以续传数据长度为0
    // 解决办法，一旦暂停，就不能再次点击！
    [self.downloadTask cancelByProducingResumeData:^(NSData *resumeData) {
        NSLog(@"暂停 %tu", resumeData.length);
        
        self.resumeData = resumeData;
        
        // 释放 downloadTask
        self.downloadTask = nil;
    }];
}

// 继续
- (IBAction)resume {
    if (self.resumeData == nil) {
        return;
    }
    
    // 发起续传的下载任务
    self.downloadTask = [self.session downloadTaskWithResumeData:self.resumeData];
    
    [self.downloadTask resume];
    
    // 任务一旦启动，续传数据就没用了
    self.resumeData = nil;
}

#pragma mark - 下载代理方法

// 1. 下载完成
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location {
    
    NSLog(@"下载完成");
}

// 2. 下载进度
/**
 bytesWritten               本次下载大小
 totalBytesWritten          已经下载大小
 totalBytesExpectedToWrite  文件总大小
 */
- (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite {
    
    float progress = (float)totalBytesWritten / totalBytesExpectedToWrite;
    NSLog(@"%.02f %@", progress, [NSThread currentThread]);
    
    dispatch_async(dispatch_get_main_queue(), ^{self.progressButton.progress = progress;});
}

@end