NSURLSession下载与缓存

iOS9要求网络请求需要使用NSURLSession,那么本篇文章
就使用NSURLsession来实现视频的下载,图片的下载、取消下载、恢复下
载和缓存功能，期望与大家一起学习。

• NSURLSessionConfiguration(参数配置类)

  NSURLSession状态同时对应着多个连接,不像之前使用共享的一个全局状态。会话是通过工厂方法（类方法)来创建对象
  NSURLSessionConfiguration。

  总共有三种会话：

  1.defaultSessionConfiguration 默认的，进程内会话

  2.ephemeralSessionConfiguration短暂的（内
  存），进程内会话

3.backgroundSessionConfigurationWithIdentifier后台会话

• 相关属性

  //后台任务的标识符

  @property (nullable, readonly, copy) NSString *id entifier;
  

  //缓存的策略

  @property NSURLRequestCachePolicy requestCachePolicy;

  //请求超时时长

  @property NSTimeInterval timeoutIntervalForRequest;

  //网络服务类型

  @property NSURLRequestNetworkServiceType networkServiceType;

  //是否在非无线的情况下请求网络

  @property BOOL allowsCellularAccess;

手动下载视频

• 步骤：

  • 在Info.plist中添加NSAppTransportSecurity类型Dictionary。
    在NSAppTransportSecurity下添加NSAllowsArbitraryLoads类型Boolean,值设为YES;

  • 在工程内引入AVFoundation框架，并在相关类引入AVKit、AVFoundation头文件;

  • 遵守NSURLSessionDelegate，NSURLSessionDownloadDelegate协议；

  • 准备一个MP4格式的url，进行下载；

  • 将下载完成的视频资源存入本地，并进行播放。

• 声明相关属性

 //下载任务  
 @property (nonatomic, strong)NSURLSessionDownloadTask *downTask;  
      
 //网络会话  
 @property (nonatomic, strong)NSURLSession * downLoadSession;

• 配置相关参数并下载

    //参数设置类  简单的网络下载使用             
      defaultSessionConfiguration即可
    NSURLSessionConfiguration          *sessionConfig =        
    [NSURLSessionConfiguration
    defaultSessionConfiguration];
    
     //创建网络会话  
     self.downLoadSession = [NSURLSession sessionWithConfiguration:sessionConfig delegate:self delegateQueue:[NSOperationQueue new]];
    
    
     //数据请求  
     /*
      *@param URL 资源url  
      *@param timeoutInterval 超时时长
      */
    NSURLRequest *imgRequest = [NSURLRequest requestWithURL:[NSURL URLWithString:MP3URL] cachePolicy:5 timeoutInterval:60.f];
    
     //创建下载任务  
    self.downTask = [self.downLoadSession downloadTaskWithRequest:imgRequest];
    
     //启动下载任务  
    [self.downTask resume];

• 实现代理方法

  #pragma mark 下载过程

  -(void)URLSession:(NSURLSession *)sessiondownloadTask:(NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
{
   //获取下载进度
    double currentProgress = totalBytesWritten / (double)totalBytesExpectedToWrite;
    
    dispatch_async(dispatch_get_main_queue(), ^{
       
   //进行UI操作  设置进度条
        
        self.downLoadProgress.progress = currentProgress;
    
    });
    
  #pragma mark 下载完成 无论成功失败

 -(void)URLSession:(NSURLSession *)session task: (NSURLSessionTask *)task didCompleteWithError:(NSError *)error
 {
    
        NSLog(@" function == %s, line == %d, error ==  %@",__FUNCTION__,__LINE__,error);
    
 }
   #pragma mark - 下载成功 获取下载内容
 -(void)URLSession:(NSURLSession *)session   downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
 {
    //存储本地
    
    //1.获取Documents文件夹路径 （不要将视频、音频等较大资源存储在Caches路径下）
        *方法一
        NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES) lastObject];
        
        *方法二
        NSFileManager *manager = [NSFileManager defaultManager];
        NSURL * documentsDirectory = [fileManager URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask][0];
        
   //2.创建资源存储路径
       NSString *appendPath = [NSString stringWithFormat:@"/new.mp4"];
       NSString *file = [documentsPath stringByAppendingString:appendPath];

   //3.将下载好的视频资源存储在路径下
     
      //删除之前相同路径的文件
      BOOL remove  = [manager removeItemAtPath:file error:nil];
      
      //将视频资源从原有路径移动到自己指定的路径
      BOOL success = [manager copyItemAtPath:location.path toPath:file error:nil];

        if (success) {
    
      //回到主线程进行本地视频播放
        dispatch_async(dispatch_get_main_queue(), ^{
            
        //创建视频播放的本地路径
            
        *** 请使用此方法创建本地路径
        NSURL *url = [[NSURL alloc]initFileURLWithPath:file];
           
        *** 此方法创建的路径无法播放 不是一个完整的路径
        //NSURL *url2 = [[NSURL alloc]initWithString:file];
            
        //系统的视频播放器
        AVPlayerViewController *controller = [[AVPlayerViewController alloc]init];
        //播放器的播放类
        AVPlayer * player = [[AVPlayer alloc]initWithURL:url];
            
        controller.player = player;
        //自动开始播放
        [controller.player play];
        //推出视屏播放器
        [self presentViewController:controller animated:YES completion:nil];
                      
            
        });
    }

 }    

• NSURLSessionDownloadTask支持取消下载，可以在下载过程中随时取消继续下载，同时也可以实现恢复下载。

  • 取消下载 cancelByProducingResumeData

    //用当前NSURLSessionDownloadTask对象去调用取消下载
    
    [self.downTask cancelByProducingResumeData:
     ^(NSData * _Nullable resumeData) {
     
     //全局变量 接收当前下载的资源
     self.data = resumeData;
     }
     //将当前下载任务置为空
     self.downTask = nil;
    
    

  • 恢复下载 downloadTaskWithResumeData

           
    //恢复下载 实际上是建立了一个新的下载任务 去继续之前的下载
          
    self.downTask = [self.downLoadSession downloadTaskWithResumeData:self.data];
      
     //开启任务     
    [self.downTask resume];
          
      }
    

  
##自动缓存

   >上面讲到的是自己去手动操控整个下载过程，那么，很多伙伴就会讲这样是不是太麻烦了。如果你了解了NSURLSession的缓存策略，那么，你就会发现，我们这么写确实是太麻烦了，那么下面我们就来学习一下NSURsession的自动缓存。
     
  >在开始之前，先介绍一下`NSURLRequestUseProtocolCachePolicy`的几种缓存策略：
    
  >  1>`NSURLRequestUseProtocolCachePolicy` = 0, 默认的缓存策略， 如果缓存不存在，直接从服务端获取。如果缓存存在，
会根据response中的Cache-Control字段判断下一步操作，如: Cache-Control字段为must-revalidata, 则询问服务端该数据是否有更新，无更新的话直接返回给用户缓存数据，若已更新，则请求服务端.

   > 2>`NSURLRequestReloadIgnoringLocalCacheData` = 1, 忽略本地缓存数据，直接请求服务端.

   > 3>`NSURLRequestIgnoringLocalAndRemoteCacheData` = 4, 忽略本地缓存，代理服务器以及其他中介，直接请求源服务端.

    >4>`NSURLRequestReloadIgnoringCacheData` = NSURLRequestReloadIgnoringLocalCacheData

    >5>`NSURLRequestReturnCacheDataElseLoad` = 2, 有缓存就使用，不管其有效性(即忽略Cache-Control字段), 无则请求服务端.

    >6>`NSURLRequestReturnCacheDataDontLoad` = 3, 死活加载本地缓存. 没有就失败. (确定当前无网络时使用).

   >7>`NSURLRequestReloadRevalidatingCacheData` = 5, 缓存数据必须得得到服务端确认有效才使用(貌似是NSURLRequestUseProtocolCachePolicy中的一种情况)
 
 因此，我们可以根据自己的需求去设置不同的缓存策略，而默认的就是如果有缓存就通过缓存获取数据，没有缓存就去请求网络数据。
     这里，我们通过一个请求图片的例子，来窥探一下神奇的自动缓存。
   
- 代码： 

//创建一个UIImageView+MyImageView.h的类目，
在.h添加一个方法

• (void)loadIamgeWithURL:(NSString *)urlString
  //在.m去实现此方法

• (void)loadIamgeWithURL:(NSString *)urlString
  {

  //创建下载图片的url
  NSURL *url = [NSURL URLWithString:urlString];

  //创建网络请求配置类
  NSURLSessionConfiguration * configuration = [NSURLSessionConfiguration defaultSessionConfiguration];

  //创建网络会话
  NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:nil delegateQueue:[NSOperationQueue new]];

  //创建请求并设置缓存策略以及超时时长
  NSURLRequest imgRequest = [NSURLRequest requestWithURL:url cachePolicy:0 timeoutInterval:30.f];
  //也可通过configuration.requestCachePolicy 设置缓存策略

  //创建一个下载任务
  NSURLSessionDownloadTask *task = [session downloadTaskWithRequest:imgRequest completionHandler:^(NSURL * _Nullable location, NSURLResponse * _Nullable response, NSError * _Nullable error) {

  //下载完成后获取数据 此时已经自动缓存到本地，下次会直接从本地缓存获取，不再进行网络请求
  NSData * data = [NSData dataWithContentsOfURL:location];

  //回到主线程
  dispatch_async(dispatch_get_main_queue(), ^{

  //设置图片
  self.image = [UIImage imageWithData:data];
  });

}];


//启动下载任务
[task resume];

}

   >通过这种缓存策略，我们就可以实现图片下载并自动缓存，当我们需要再次使用此资源的时候，它就会自动去本地缓存查找是否有已经下载好的图片资源，如果有就会直接去本地的，从而不需要再去进行网络请求。可以在下载完成后，将网络断开进行测试。

## 总结
  本次主要是讲解了NSURLSession的下载，以及自动缓存策略。它的功能非常强大，还有很多没来得及细细研究，如果你也喜欢它😍，那就抓紧时间去研究吧~