iOS网络-04-大文件下载

大文件下载注意事项

• 若不对下载的文件进行转存，会造成内存消耗急剧升高，甚至耗尽内存资源，造成程序终止。
• 在文件下载过程中通常会出现中途停止的状况，若不做处理，就要重新开始下载，浪费流量。

大文件下载的解决方案

• 对下载文件进行处理，每下载一点数据，就将数据写到磁盘中（通常是沙盒中），避免在内存累积数据（NSURLConnection下载）
  
  • 使用NSFileHandle类实现写数据
  • 使用NSOutputStream类实现写数据
• 当下载任务终止时，记录任务终止时的位置信息，以便下次开始继续下载

大文件下载（NSURLConnection）

• 未支持断点下载
• 使用NSURLConnection的代理方式下载文件
• 在下载任务的不同阶段回调的代理方法中，完成转移下载文件，及记录终止位置的任务

• 使用NSFileHandle类实现写数据的下载步骤(完整核心代码)

  • 设置相关成员属性

  /**所要下载文件的总长度*/
  @property (nonatomic, assign) NSInteger contentLength;
  /**已下载文件的总长度*/
  @property (nonatomic, assign) NSInteger currentLength
  /**文件句柄，用来实现文件存储*/
  @property (nonatomic, strong) NSFileHandle *handle;

  • 创建、发送请求

  // 1. 创建请求路径
  NSURL *url = [NSURL URLWithString:@"此处为URL字符串"];
  // 2. 将URL封装成请求
  NSURLRequest *request = [NSURLRequest requestWithURL:url];
  // 3. 通过NSURLConnection，并设置代理
  [NSURLConnection connectionWithRequest:request delegate:self];

  • 遵守代理协议NSURLConnectionDataDelegate，实现代理方法

  /**
  * 接收到服务器响应时调用的方法
  */
  - (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSHTTPURLResponse *)response
  {
      //获取所要下载文件的总长度
      self.contentLength = [response.allHeaderFields[@"Content-Length"] integerValue];
      //拼接一个沙盒中的文件路径
      NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"minion_15.mp4"];
      //创建指定路径的文件
      [[NSFileManager defaultManager] createFileAtPath:filePath contents:nil attributes:nil];
      //创建文件句柄
      self.handle = [NSFileHandle fileHandleForWritingAtPath:filePath];
  }
  /**
  * 接收到服务器的数据时调用的方法
  */
  - (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
  {
      //定位到文件尾部，将服务器每次返回的文件数据都拼接到文件尾部
      [self.handle seekToEndOfFile];
      //通过文件句柄，将文件写入到沙盒中
      [self.handle writeData:data];
      //拼接已下载文件总长度
      self.currentLength += data.length;
      //计算下载进度
      CGFloat progress = 1.0 * self.currentLength / self.contentLength;
  }
  /**
  * 文件下载完毕时调用的方法
  */
  - (void)connectionDidFinishLoading:(NSURLConnection *)connection
  {
      //关闭文件句柄，并清除
      [self.handle closeFile];
      self.handle = nil;
      //清空已下载文件长度
      self.currentLength = 0;
  }

• 使用NSOutputStream类实现写数据的下载步骤（部分代码，其他部分代码同上）

  • 设置NSOutputStream成员属性

  @property (nonatomic, strong) NSOutputStream *stream;

  • 初始化NSOutputStream对象，打开输出流

  /**接收到服务器响应的时候调用*/
  - (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
  {
      //获取下载数据保存的路径
      NSString *cache = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
      NSString *filePath = [cache stringByAppendingPathComponent:response.suggestedFilename];
      //利用NSOutputStream往filePath文件中写数据，若append参数为yes，则会写到文件尾部
      self.stream = [[NSOutputStream alloc] initToFileAtPath:filePath append:YES];
      //打开数据流
      [self.stream open];
  }

  • 写文件数据

  /**接收到数据的时候调用*/
  - (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
  {
      [self.stream write:[data bytes] maxLength:data.length];
  }

  • 关闭输出流

  /**数据下载完毕的时候调用*/
  - (void)connectionDidFinishLoading:(NSURLConnection *)connection
  {
      [self.stream close];
  }

大文件下载（NSURLSession）

• 支持断点下载，自动记录停止下载时断点的位置
• 遵守NSURLSessionDownloadDelegate协议
• 使用NSURLSession下载大文件，被下载文件会被自动写入沙盒的临时文件夹tmp中
• 下载完毕，通常需要将已下载文件移动其他位置（tmp文件夹中的数据被定时删除），通常是cache文件夹中

• 详细的下载步骤

  • 设置下载任务task的为成员变量

  @property (nonatomic, strong) NSURLSessionDownloadTask *task;

  • 获取NSURLSession对象

  NSURLSession *session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];

  • 初始化下载任务任务

  self.task = [session downloadTaskWithURL:（此处为下载文件路径URL）];

  • 实现代理方法

  /**每当写入数据到临时文件的时候，就会调用一次该方法，通常在该方法中获取下载进度*/
  - (void)URLSession:(NSURLSession *)session downloadTask: (NSURLSessionDownloadTask *)downloadTask didWriteData:(int64_t)bytesWritten totalBytesWritten:(int64_t)totalBytesWritten totalBytesExpectedToWrite:(int64_t)totalBytesExpectedToWrite
  {
      // 计算下载进度
      CGFloat progress = 1.0 * totalBytesWritten / totalBytesExpectedToWrite;
  }
  
  /**任务终止时调用的方法，通常用于断点下载*/
  - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didResumeAtOffset:(int64_t)fileOffset expectedTotalBytes:(int64_t)expectedTotalBytes
  {
      //fileOffset：下载任务中止时的偏移量
  }
  
  /**遇到错误的时候调用，error参数只能传递客户端的错误*/
  - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
  { }
  
  /**下载完成的时候调用，需要将文件剪切到可以长期保存的文件夹中*/
  - (void)URLSession:(NSURLSession *)session downloadTask:(NSURLSessionDownloadTask *)downloadTask didFinishDownloadingToURL:(NSURL *)location
  {
      //生成文件长期保存的路径
      NSString *file = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:downloadTask.response.suggestedFilename];
      //获取文件句柄
      NSFileManager *fileManager = [NSFileManager defaultManager];
      //通过文件句柄，将文件剪切到文件长期保存的路径
      [fileManager moveItemAtURL:location toURL:[NSURL fileURLWithPath:file] error:nil];
  }

  • 操作任务状态

  /**开始/继续下载任务*/
  [self.task resume];
  
  /**暂停下载任务*/
  [self.task suspend];

本博客的最新状态将会同步到新浪微博账号：世俗孤岛