（一二七）NSURLSession的基本用法 下载与数据获取

简介

NSURLSession是苹果官方提供的一系列网络接口库，使用他们可以轻松实现下载和数据获取等任务。在上一篇文章中，我们介绍了使用NSURLConnection下载文件和断点续传的功能，实现起来比较麻烦，对于文件的操作也比较繁琐，如果使用NSURLSession，这一切都将变得极为容易。

用法

• 数据请求
  1.获取URLSession单例对象，并利用该对象创建一个dataTask，使用结构体回调。
  这段代码从网站上抓取JSON数组，解析为OC字典。

  NSURLSession *session = [NSURLSession sharedSession];
  NSURLSessionDataTask *task = [session dataTaskWithURL:[NSURL URLWithString:@"http://www.soulghost.com/randompk/storeTest/baseRandom.php?type=attack"] completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:nil];
  NSLog(@"%@",dict);
  }];

  2.开启任务
  所有任务在创建时都是暂停的，应该手动启动。

  [task resume];

• 小文件下载
  1.获取URLSession单例对象，创建一个downloadTask。

  • 注意此任务默认将文件下载到tmp文件夹，并且在下载结束后如果不处理会秒删，一般的做法是把它移动到Document或者Caches中，当下载结束后会调用结构体，在结构体里处理文件即可。

  • 通过NSFileManager可以实现文件的复制、移动操作，回调的location是tmp中刚刚下载的文件的URL。

    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDownloadTask *task = [session downloadTaskWithURL:[NSURL URLWithString:@"http://127.0.0.1/lesson1/nav.dmg"] completionHandler:^(NSURL *location, NSURLResponse *response, NSError *error) {
    // 临时下载到tmp，必须及时处理，否则会被系统秒删。
    // 应该将临时文件移动到Caches文件夹
    NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    // 可以使用建议的文件名，与服务端一致
    NSString *file = [path stringByAppendingPathComponent:response.suggestedFilename];
    // 移动文件
    NSFileManager *mgr = [NSFileManager defaultManager];
    [mgr moveItemAtPath:location.path toPath:file error:nil];
    }];

    2.开启任务
    所有任务在创建时都是暂停的，应该手动启动。

    [task resume];

• 大文件下载
  大文件常常需要获取进度，这就需要设置代理，而不是用block回调。
  1.遵循代理方法，创建两个成员，一个用于指向下载任务对象，另一个用于保存断点数据。

  @interface ViewController () <NSURLSessionDownloadDelegate>
  @property (nonatomic, strong) NSURLSessionDownloadTask *task;
  @property (nonatomic, strong) NSData *resumeData;
  @end

  2.获取URLSession单例，创建下载任务，注意使用的方法与前面不同。

  • 不要忘了保存task。

  NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
  NSURLSessionDownloadTask *task = [session downloadTaskWithURL:[NSURL URLWithString:@"http://127.0.0.1/lesson1/nav.dmg"] ];
  [task resume];
  _task = task;

  3.下载过程中会调用下面的代理方法，指示此次下载的字节数，一共下载的字节数与总字节数。

  - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite{
  NSLog(@"写入量:%lld 下载进度:%f",bytesWritten,(double)totalBytesWritten/totalBytesExpectedToWrite);
  }

  4.下载结束后回调用下面的代理方法，从中同样要移动文件，只是如果要想拿到响应体response的suggestedFilename，需要通过downloadTask。

  - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location{
  NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
  // 可以使用建议的文件名，与服务端一致
  NSString *file = [path stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
  // 移动文件
  NSFileManager *mgr = [NSFileManager defaultManager];
  [mgr moveItemAtPath:location.path toPath:file error:nil];
  
  [self.btn setTitle:@"Start" forState:UIControlStateNormal];
  }

  5.如果要暂停下载，调用下面的方法，通过回调结构体拿到断点数据，保存在我们之前创建的成员中以便恢复。

  • 注意用weakSelf避免循环引用。
  • 任务结束后就无效了，应该让指针指向nil来释放内存。

  __weak typeof(self) weakSelf = self;
  [self.task cancelByProducingResumeData:^(NSData *resumeData) {
  // resumeData内部包含了下次继续下载的开始位置
  weakSelf.resumeData = resumeData;
  weakSelf.task = nil;
  }];

  6.要恢复下载数据很容易，只需要通过断点创建任务即可。

  • 注意清空resumeData。

  NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];
  // 传入上次暂停下载返回的数据
  NSURLSessionDownloadTask *task = [session downloadTaskWithResumeData:self.resumeData];
  [task resume];
  _task = task;
  _resumeData = nil;

• 断点续传开始时会调用下面的代理方法说明文件信息。

  - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes{
  }