iOS開發之網絡編程--4、NSURLSessionDataTask實現文件下載(離線斷點續傳下載) <進度值顯示優化>

前言：根據前篇《iOS開發之網絡編程--2、NSURLSessionDownloadTask文件下載》或者《iOS開發之網絡編程--3、NSURLSessionDataTask實現文件下載(離線斷點續傳下載)》，都遺留了一個細節未處理的問題，那就是在離線斷點下載的過程中，當應用程序重新啟動之后，進度條的進度值默認沒有設置為之前已經下載的進度，根據基本公式"當前進度值 = 已經下載的數據長度 ÷ 最終下載完的數據總長度"，已經下載的數據長度可以由沙盒中已經下載的那部分數據獲取，但是最終下載完的數據總長度就需要通過網絡返回的信息了，但是別忘了，每一次重新啟動應用程序初始狀態默認都是暫停下載，或者是斷網的情況下無法請求網絡數據，那么如何獲取這個"最終下載完的數據總長度"呢？

本篇還涉及到在子線程創建下載任務，然后通過線程通知UI主線程更新進度條控件顯示進度。因為delegateQueue這個屬性可以設置主隊列線程或者是子隊列線程。

 

先看看效果：

問題解決："最終下載完的數據總長度"可以在首次從0開始下載的時候通過網絡獲取，然后將其"最終下載完的數據總長度"這個值存儲在緩存中的某個文件(這個文件可以是字典等等)中，等待下一次獲取。

　　　　   而我則采用的方法是將這個"最終下載完的數據總長度"作為文件的屬性添加進文件屬性列表中，以備下一次讀取的時候，獲得到這個文件之后，就可以讀取該文件的屬性列表中的"最終下載完

　　　　　的數據總長度"的屬性和屬性值。

在這里不得不先介紹一個工具類，讀者可以通過本人的另一篇博文隨筆先了解其功能：iOS開發 -- 為本地文件添加自定義屬性的工具類

為本地文件添加屬性之后，可以打印看的到：

本人花了點時間將網絡下載這部分簡單的封裝成了一個工具類：DownloadTool，下面就展示源碼：

DownloadTool.h

#import <Foundation/Foundation.h>


// 定義一個block用來傳遞進度值
typedef  void (^SetProgressValue)(float progressValue);

@interface DownloadTool : NSObject

/** 創建下載工具對象 */
+ (instancetype)DownloadWithURLString:(NSString*)urlString setProgressValue:(SetProgressValue)setProgressValue;
/** 開始下載 */
-(void)startDownload;
/** 暫停下載 */
-(void)suspendDownload;

@end

DownloadTool.m

#import "DownloadTool.h"

#import "ExpendFileAttributes.h"

#define Key_FileTotalSize @"Key_FileTotalSize"

@interface DownloadTool () <NSURLSessionDataDelegate>
/** Session會話 */
@property (nonatomic,strong)NSURLSession *session;
/** Task任務 */
@property (nonatomic,strong)NSURLSessionDataTask *task;
/** 文件的全路徑 */
@property (nonatomic,strong)NSString *fileFullPath;
/** 傳遞進度值的block */
@property (nonatomic,copy) SetProgressValue setProgressValue;
/** 當前已經下載的文件的長度 */
@property (nonatomic,assign)NSInteger currentFileSize;
/** 輸出流 */
@property (nonatomic,strong)NSOutputStream *outputStream;
/** 不變的文件總長度 */
@property (nonatomic,assign)NSInteger fileTotalSize;
@end

@implementation DownloadTool

+ (instancetype)DownloadWithURLString:(NSString*)urlString setProgressValue:(SetProgressValue)setProgressValue{
    DownloadTool* download = [[DownloadTool alloc] init];
    download.setProgressValue = setProgressValue;
    [download getFileSizeWithURLString:urlString];
    [download creatDownloadSessionTaskWithURLString:urlString];
    NSLog(@"%@",download.fileFullPath);
    return download;
}
// 剛創建該網絡下載工具類的時候，就需要查詢本地是否有已經下載的文件，並返回該文件已經下載的長度
-(void)getFileSizeWithURLString:(NSString*)urlString{
    // 創建文件管理者
    NSFileManager* fileManager = [NSFileManager defaultManager];
    // 獲取文件各個部分
    NSArray* fileComponents = [fileManager componentsToDisplayForPath:urlString];
    // 獲取下載之后的文件名
    NSString* fileName = [fileComponents lastObject];
    // 根據文件名拼接沙盒全路徑
    NSString* fileFullPath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:fileName];
    self.fileFullPath = fileFullPath;
    
    NSDictionary* attributes = [fileManager attributesOfItemAtPath:fileFullPath
                                                             error:nil];
    // 如果有該文件，且為下載沒完成，就直接拿出該文件的長度設置進度值，並設置當前的文件長度
    NSInteger fileCurrentSize = [attributes[@"NSFileSize"] integerValue];
    // 如果文件長度為0，就不需要計算進度值了
    if (fileCurrentSize != 0) {
        // 獲取最終的文件中長度
        NSInteger fileTotalSize = [[ExpendFileAttributes stringValueWithPath:self.fileFullPath key:Key_FileTotalSize] integerValue];
        self.currentFileSize = fileCurrentSize;
        self.fileTotalSize = fileTotalSize;
        // 設置進度條的值
        self.setProgressValue(1.0 * fileCurrentSize / fileTotalSize);
    }
    NSLog(@"當前文件長度：%lf" , self.currentFileSize * 1.0);
}
#pragma mark - 創建網絡請求會話和任務，並啟動任務
-(void)creatDownloadSessionTaskWithURLString:(NSString*)urlString{
    //判斷文件是否已經下載完畢
    if (self.currentFileSize == self.fileTotalSize && self.currentFileSize != 0) {
        NSLog(@"文件已經下載完畢");
        return;
    }
    NSURLSession* session =
    [NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]
                                  delegate:self
                             delegateQueue:[[NSOperationQueue alloc]init]];
    NSURL* url = [NSURL URLWithString:urlString];
    NSMutableURLRequest* request = [NSMutableURLRequest requestWithURL:url];
    //2.3 設置請求頭
    NSString *range = [NSString stringWithFormat:@"bytes=%zd-",self.currentFileSize];
    [request setValue:range forHTTPHeaderField:@"Range"];
    NSURLSessionDataTask* task = [session dataTaskWithRequest:request];
    self.session = session;
    self.task = task;
}

#pragma mark - 控制下載的狀態
// 開始下載
-(void)startDownload{
    [self.task resume];
}
// 暫停下載
-(void)suspendDownload{
    [self.task suspend];
}
#pragma mark - NSURLSessionDataDelegate 的代理方法
// 收到響應調用的代理方法
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:
(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler{
    NSLog(@"執行了收到響應調用的代理方法");
    // 創建輸出流，並打開流
    NSOutputStream* outputStream = [[NSOutputStream alloc] initToFileAtPath:self.fileFullPath append:YES];
    [outputStream open];
    self.outputStream = outputStream;
    // 如果當前已經下載的文件長度等於0，那么就需要將總長度信息寫入文件中
    if (self.currentFileSize == 0) {
        NSInteger totalSize = response.expectedContentLength;
        NSString* totalSizeString = [NSString stringWithFormat:@"%ld",totalSize];
        [ExpendFileAttributes extendedStringValueWithPath:self.fileFullPath key:Key_FileTotalSize value:totalSizeString];
        // 別忘了設置總長度
        self.fileTotalSize = totalSize;
    }
    // 允許收到響應
    completionHandler(NSURLSessionResponseAllow);
}
// 收到數據調用的代理方法
-(void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data{
    NSLog(@"執行了收到數據調用的代理方法");
    // 通過輸出流寫入數據
    [self.outputStream write:data.bytes maxLength:data.length];
    // 將寫入的數據的長度計算加進當前的已經下載的數據長度
    self.currentFileSize += data.length;
    // 設置進度值
    NSLog(@"當前文件長度：%lf，總長度：%lf",self.currentFileSize * 1.0,self.fileTotalSize * 1.0);
    NSLog(@"進度值: %lf",self.currentFileSize * 1.0 / self.fileTotalSize);
    // 獲取主線程
    NSOperationQueue* mainQueue = [NSOperationQueue mainQueue];
    [mainQueue addOperationWithBlock:^{
        self.setProgressValue(self.currentFileSize * 1.0 / self.fileTotalSize);
    }];
}
// 數據下載完成調用的方法
-(void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error{
    // 關閉輸出流 並關閉強指針
    [self.outputStream close];
    self.outputStream = nil;
    // 關閉會話
    [self.session invalidateAndCancel];
    NSLog(@"%@",[NSThread currentThread]);
}
-(void)dealloc{
}
@end

使用示例源碼：

#import "ViewController.h"
#import "RainbowProgress.h"

#import "DownloadTool.h"

#define MP4_URL_String @"http://120.25.226.186:32812/resources/videos/minion_12.mp4"


@interface ViewController ()
@property (weak, nonatomic) IBOutlet UILabel *showDownloadState;
/** 彩虹進度條 */
@property (nonatomic,weak)RainbowProgress *rainbowProgress;
/** 網絡下載工具對象 */
@property (nonatomic,strong)DownloadTool *download;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    [self setSelfView];
    [self addProgress];
    [self addDownload];
    
}
// 啟動和關閉的網絡下載開關
- (IBAction)SwitchBtn:(UISwitch *)sender {
    if (sender.isOn) {
        self.showDownloadState.text = @"開始下載";
        [self.download startDownload];
    }else{
        self.showDownloadState.text = @"暫停下載";
        [self.download suspendDownload];
    }
}
#pragma mark - 設置控制器View
-(void)setSelfView{
    self.view.backgroundColor = [UIColor blackColor];
}
#pragma mark - 添加彩虹進度條
-(void)addProgress{
    // 創建彩虹進度條,並啟動動畫
    RainbowProgress* rainbowProgress = [[RainbowProgress alloc] init];
    [rainbowProgress startAnimating];
    [self.view addSubview:rainbowProgress];
    self.rainbowProgress = rainbowProgress;
}
#pragma mark - 創建網絡下載任務
-(void)addDownload{
    DownloadTool* download = [DownloadTool DownloadWithURLString:MP4_URL_String setProgressValue:^(float progressValue) {
        self.rainbowProgress.progressValue = progressValue;
    }];
    self.download = download;
}

#pragma mark - 設置狀態欄樣式
-(UIStatusBarStyle)preferredStatusBarStyle{
    return UIStatusBarStyleLightContent;
}

@end

效果圖(中間有個過程是重新啟動應用程序看看進度條顯示的效果，然后繼續測試開始下載和暫停下載)：

 

百度雲分享源碼鏈接: http://pan.baidu.com/s/1eRwRkZo 密碼: 787n

轉載請注明出處：http://www.cnblogs.com/goodboy-heyang/p/5200873.html ，尊重勞動成果。