---

媒介

收集下載是我們在項目中常常要用到的功效，假如是小文件的下載，好比圖片和文字之類的，我們可以直接要求源地址，然後一次下載終了。然則假如是下載較年夜的音頻和視頻文件，弗成能一次下載終了，用戶能夠下載一段時光，封閉法式，回家接著下載。這個時刻，就須要完成斷點續傳的功效。讓用戶可以隨時暫停下載，下次開端下載，還能接著前次的下載的進度。

明天我們來看看若何本身簡略的封裝一個斷點續傳的類，完成以下功效。

    1.應用者只須要挪用一個接口便可以下載，同時可以獲得下載的進度。

    2.下載勝利，可以獲得文件存儲的地位

    3.下載掉敗，給出掉敗的緣由

    4.可以暫停下載，下次開端下載，接著前次的進度持續下載

道理講授

要完成斷點續傳的功效，平日都須要客戶端記載下以後的下載進度，並在須要續傳的時刻告訴辦事端本次須要下載的內容片斷。

在HTTP1.1協定（RFC2616）中界說了斷點續傳相干的HTTP頭的Range和Content-Range字段，一個最簡略的斷點續傳完成年夜概以下：

    1.客戶端下載一個1024K的文件，曾經下載了個中512K

    2.收集中止，客戶端要求續傳，是以須要在HTTP頭中聲名本次須要續傳的片斷：Range:bytes=512000-這個頭告訴辦事端從文件的512K地位開端傳輸文件
    3.辦事端收到斷點續傳要求，從文件的512K地位開端傳輸，而且在HTTP頭中增長：Content-Range:bytes 512000-/1024000而且此時辦事端前往的HTTP狀況碼應當是206，而不是200。

難點解釋

1. 客戶端若何獲得曾經下載的文件字節數

客戶端這邊，我們須要記載下每次用戶每次下載的文件年夜小，然後完成道理講授中步調1的功效。

那末若何記錄呢？

其實我們可以直接獲得指定途徑下文件的年夜小，IOS曾經供給了相干的功效，完成代碼以下，

[[[NSFileManager defaultManager] attributesOfItemAtPath: FileStorePath error:nil][NSFileSize] integerValue]

2.若何獲得被下載文件的總字節數

上一步，我們獲得了曾經下載文件的字節數，這裡我們須要獲得被下載文件的總字節數，有了這兩個值，我們便可以算出下載進度了。

那末若何獲得呢？這裡我們須要用到http 頭部的conten-length字段，先來看看該字段的寄義

Content-Length用於描寫HTTP新聞實體的傳輸長度the transfer-length of the message-body。在HTTP協定中，新聞實體長度和新聞實體的傳輸長度是有差別，好比說gzip緊縮下，新聞實體長度是緊縮前的長度，新聞實體的傳輸長度是gzip緊縮後的長度。

簡略點說，content-length表現被下載文件的字節數。

比較道理講授的第三步，我們可以看到假如要盤算出文件的總字節數，那末必需把曾經下載的字節數 加上 content-length。

我們須要把每一個被下載文件的總字節數存儲起來，這裡我們選擇應用plist文件來記錄，plist文件包括一個字典。設置文件名為鍵值，曾經下載的文件字節數為值。

文件名為了避免反復，這裡我們設置文件名為下載url的hash值，可以包管不重重。

完成代碼以下：

- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSHTTPURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
  self.totalLength = [response.allHeaderFields[@"Content-Length"] integerValue] + DownloadLength;

  NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithContentsOfFile: TotalLengthPlist];

  if (dict == nil) dict = [NSMutableDictionary dictionary];
  dict[ Filename] = @(self.totalLength);

  [dict writeToFile: TotalLengthPlist atomically:YES];
}

上述NSSessionDelegate辦法會在要求收到回應的時刻挪用一次，我們可以在該辦法中獲得回應信息，掏出content-length字段。

3.封裝一個辦法，完成下載進度，勝利，掉敗提醒

我們可以模擬A.network，把下載封裝到一個辦法，然後應用分歧的block來完成下載進度，勝利，掉敗後的回調。

界說以下：

-(void)downLoadWithURL:(NSString *)URL
       progress:(progressBlock)progressBlock
        success:(successBlock)successBlock
         faile:(faileBlock)faileBlock
{
  self.successBlock = successBlock;
  self.failedBlock = faileBlock;
  self.progressBlock = progressBlock;
  self.downLoadUrl = URL;
  [self.task resume];
}

下面的三個block都采取宏界說方法，如許看起來比擬簡練，詳細代碼參考上面的完全代碼。

然後我們可以在NSURLSessionDataDelegate的對應的署理辦法中去完成三個block的挪用，然後傳入響應的參數。如許當其別人挪用我們的辦法，便可以在響應的block中完成回調。詳細代碼參考上面的完全代碼

完全代碼完成

上面是完全的代碼完成

#import <Foundation/Foundation.h>
typedef void (^successBlock) (NSString *fileStorePath);
typedef void (^faileBlock) (NSError *error);
typedef void (^progressBlock) (float progress);

@interface DownLoadManager : NSObject <NSURLSessionDataDelegate>
@property (copy) successBlock successBlock;
@property (copy) faileBlock   failedBlock;
@property (copy) progressBlock  progressBlock;


-(void)downLoadWithURL:(NSString *)URL
       progress:(progressBlock)progressBlock
        success:(successBlock)successBlock
         faile:(faileBlock)faileBlock;

+ (instancetype)sharedInstance;
-(void)stopTask;

@end

#import "DownLoadManager.h"
#import "NSString+Hash.h"

@interface DownLoadManager ()
/** 下載義務 */
@property (nonatomic, strong) NSURLSessionDataTask *task;
/** session */
@property (nonatomic, strong) NSURLSession *session;
/** 寫文件的流對象 */
@property (nonatomic, strong) NSOutputStream *stream;
/** 文件的總年夜小 */
@property (nonatomic, assign) NSInteger totalLength;
@property(nonatomic,strong)NSString *downLoadUrl;

@end


// 文件名（沙盒中的文件名），應用md5哈希url生成的，如許就可以包管文件名獨一
#define Filename self.downLoadUrl.md5String
// 文件的寄存途徑（caches）
#define FileStorePath [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent: Filename]
// 應用plist文件存儲曾經下載的文件年夜小
#define TotalLengthPlist [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"totalLength.plist"]
// 文件的已被下載的年夜小
#define DownloadLength [[[NSFileManager defaultManager] attributesOfItemAtPath: FileStorePath error:nil][NSFileSize] integerValue]

@implementation DownLoadManager

#pragma mark - 創立單例
static id _instance;

+ (instancetype)allocWithZone:(struct _NSZone *)zone
{
  static dispatch_once_t onceToken;
  dispatch_once(&onceToken, ^{
    _instance = [super allocWithZone:zone];
  });
  return _instance;
}

+ (instancetype)sharedInstance
{
  static dispatch_once_t onceToken;
  dispatch_once(&onceToken, ^{
    _instance = [[self alloc] init];
  });
  return _instance;
}

- (id)copyWithZone:(NSZone *)zone
{
  return _instance;
}

- (id)mutableCopyWithZone:(NSZone *)zone {
  return _instance;
}

#pragma mark - 地下辦法

-(void)downLoadWithURL:(NSString *)URL
       progress:(progressBlock)progressBlock
        success:(successBlock)successBlock
         faile:(faileBlock)faileBlock
{
  self.successBlock = successBlock;
  self.failedBlock = faileBlock;
  self.progressBlock = progressBlock;
  self.downLoadUrl = URL;
  [self.task resume];


}

-(void)stopTask{
  [self.task suspend ];

}


#pragma mark - getter辦法
- (NSURLSession *)session
{
  if (!_session) {
    _session = [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[[NSOperationQueue alloc] init]];
  }
  return _session;
}

- (NSOutputStream *)stream
{
  if (!_stream) {
    _stream = [NSOutputStream outputStreamToFileAtPath: FileStorePath append:YES];
  }
  return _stream;
}


- (NSURLSessionDataTask *)task
{
  if (!_task) {
    NSInteger totalLength = [[NSDictionary dictionaryWithContentsOfFile: TotalLengthPlist][ Filename] integerValue];

    if (totalLength && DownloadLength == totalLength) {
      NSLog(@"######文件曾經下載過了");
      return nil;
    }

    // 創立要求
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString: self.downLoadUrl]];

    // 設置要求頭
    // Range : bytes=xxx-xxx，從曾經下載的長度開端到文件總長度的最初都要下載
    NSString *range = [NSString stringWithFormat:@"bytes=%zd-", DownloadLength];
    [request setValue:range forHTTPHeaderField:@"Range"];

    // 創立一個Data義務
    _task = [self.session dataTaskWithRequest:request];
  }
  return _task;
}

#pragma mark - <NSURLSessionDataDelegate>
/**
 * 1.吸收到呼應
 */
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSHTTPURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler
{
  // 翻開流
  [self.stream open];

  /*
   （Content-Length字段前往的是辦事器對每次客戶端要求要下載文件的年夜小）
   好比初次客戶端要求下載文件A，年夜小為1000byte，那末第一次辦事器前往的Content-Length = 1000，
   客戶端下載到500byte，忽然中止，再次要求的range為 “bytes=500-”，那末此時辦事器前往的Content-Length為500
   所以關於單個文件停止屢次下載的情形（斷點續傳），盤算文件的總年夜小，必需把辦事器前往的content-length加上當地存儲的曾經下載的文件年夜小
   */
  self.totalLength = [response.allHeaderFields[@"Content-Length"] integerValue] + DownloadLength;

  // 把此次曾經下載的文件年夜小存儲在plist文件
  NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithContentsOfFile: TotalLengthPlist];
  if (dict == nil) dict = [NSMutableDictionary dictionary];
  dict[ Filename] = @(self.totalLength);
  [dict writeToFile: TotalLengthPlist atomically:YES];

  // 吸收這個要求，許可吸收辦事器的數據
  completionHandler(NSURLSessionResponseAllow);
}

/**
 * 2.吸收到辦事器前往的數據（這個辦法能夠會被挪用N次）
 */
- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data
{
  // 寫入數據
  [self.stream write:data.bytes maxLength:data.length];

  float progress = 1.0 * DownloadLength / self.totalLength;
  if (self.progressBlock) {
    self.progressBlock(progress);
  }
  // 下載進度
}

/**
 * 3.要求終了（勝利\掉敗）
 */
- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error
{
  if (error) {
    if (self.failedBlock) {
      self.failedBlock(error);
    }
    self.stream = nil;
    self.task = nil;

  }else{
    if (self.successBlock) {
      self.successBlock(FileStorePath);
    }
    // 封閉流
    [self.stream close];
    self.stream = nil;
    // 消除義務
    self.task = nil;
  }
}

@end

若何挪用

@interface ViewController ()
@end

@implementation ViewController
/**
 * 開端下載
 */
- (IBAction)start:(id)sender {
  // 啟動義務
  NSString * downLoadUrl = @"http://audio.xmcdn.com/group11/M01/93/AF/wKgDa1dzzJLBL0gCAPUzeJqK84Y539.m4a";

  [[DownLoadManager sharedInstance]downLoadWithURL:downLoadUrl progress:^(float progress) {
    NSLog(@"###%f",progress);

  } success:^(NSString *fileStorePath) {
    NSLog(@"###%@",fileStorePath);

  } faile:^(NSError *error) {
    NSLog(@"###%@",error.userInfo[NSLocalizedDescriptionKey]);
  }];
}
/**
 * 暫停下載
 */
- (IBAction)pause:(id)sender {
  [[DownLoadManager sharedInstance]stopTask];
}

@end

總結

這裡只能完成單個義務下載，年夜家可以本身想一想方法，看若何完成多義務下載，而且完成斷點續傳功效。而且為了加倍便於操作，建議把存儲信息換成應用數據庫存儲。以上就是這篇文章的全體內容了，願望對年夜家進修IOS開辟有所贊助。

【iOS開辟收集編程之斷點續傳】的相關資料介紹到這裡，希望對您有所幫助！ 提示：不會對讀者因本文所帶來的任何損失負責。如果您支持就請把本站添加至收藏夾哦！