iOS開(kāi)發(fā)網(wǎng)絡(luò)編程之?dāng)帱c(diǎn)續(xù)傳
前言
網(wǎng)絡(luò)下載是我們?cè)陧?xiàng)目中經(jīng)常要用到的功能,如果是小文件的下載,比如圖片和文字之類(lèi)的,我們可以直接請(qǐng)求源地址,然后一次下載完畢。但是如果是下載較大的音頻和視頻文件,不可能一次下載完畢,用戶可能下載一段時(shí)間,關(guān)閉程序,回家接著下載。這個(gè)時(shí)候,就需要實(shí)現(xiàn)斷點(diǎn)續(xù)傳的功能。讓用戶可以隨時(shí)暫停下載,下次開(kāi)始下載,還能接著上次的下載的進(jìn)度。
今天我們來(lái)看看如何自己簡(jiǎn)單的封裝一個(gè)斷點(diǎn)續(xù)傳的類(lèi),實(shí)現(xiàn)如下功能。
1.使用者只需要調(diào)用一個(gè)接口即可以下載,同時(shí)可以獲取下載的進(jìn)度。
2.下載成功,可以獲取文件存儲(chǔ)的位置
3.下載失敗,給出失敗的原因
4.可以暫停下載,下次開(kāi)始下載,接著上次的進(jìn)度繼續(xù)下載
原理講解
要實(shí)現(xiàn)斷點(diǎn)續(xù)傳的功能,通常都需要客戶端記錄下當(dāng)前的下載進(jìn)度,并在需要續(xù)傳的時(shí)候通知服務(wù)端本次需要下載的內(nèi)容片段。
在HTTP1.1協(xié)議(RFC2616)中定義了斷點(diǎn)續(xù)傳相關(guān)的HTTP頭的Range
和Content-Range
字段,一個(gè)最簡(jiǎn)單的斷點(diǎn)續(xù)傳實(shí)現(xiàn)大概如下:
1.客戶端下載一個(gè)1024K的文件,已經(jīng)下載了其中512K
2.網(wǎng)絡(luò)中斷,客戶端請(qǐng)求續(xù)傳,因此需要在HTTP頭中申明本次需要續(xù)傳的片段:Range:bytes=512000-
這個(gè)頭通知服務(wù)端從文件的512K位置開(kāi)始傳輸文件
3.服務(wù)端收到斷點(diǎn)續(xù)傳請(qǐng)求,從文件的512K位置開(kāi)始傳輸,并且在HTTP頭中增加:Content-Range:bytes 512000-/1024000
并且此時(shí)服務(wù)端返回的HTTP狀態(tài)碼應(yīng)該是206,而不是200。
難點(diǎn)說(shuō)明
1. 客戶端如何獲取已經(jīng)下載的文件字節(jié)數(shù)
客戶端這邊,我們需要記錄下每次用戶每次下載的文件大小,然后實(shí)現(xiàn)原理講解中步驟1的功能。
那么如何記載呢?
其實(shí)我們可以直接獲取指定路徑下文件的大小,iOS已經(jīng)提供了相關(guān)的功能,實(shí)現(xiàn)代碼如下,
[[[NSFileManager defaultManager] attributesOfItemAtPath: FileStorePath error:nil][NSFileSize] integerValue]
2.如何獲取被下載文件的總字節(jié)數(shù)
上一步,我們獲取了已經(jīng)下載文件的字節(jié)數(shù),這里我們需要獲取被下載文件的總字節(jié)數(shù),有了這兩個(gè)值,我們就可以算出下載進(jìn)度了。
那么如何獲取呢?這里我們需要用到http 頭部的conten-length
字段,先來(lái)看看該字段的含義
Content-Length
用于描述HTTP消息實(shí)體的傳輸長(zhǎng)度the transfer-length of the message-body
。在HTTP協(xié)議中,消息實(shí)體長(zhǎng)度和消息實(shí)體的傳輸長(zhǎng)度是有區(qū)別,比如說(shuō)gzip壓縮下,消息實(shí)體長(zhǎng)度是壓縮前的長(zhǎng)度,消息實(shí)體的傳輸長(zhǎng)度是gzip壓縮后的長(zhǎng)度。
簡(jiǎn)單點(diǎn)說(shuō),content-length
表示被下載文件的字節(jié)數(shù)。
對(duì)比原理講解的第三步,我們可以看到如果要計(jì)算出文件的總字節(jié)數(shù),那么必須把已經(jīng)下載的字節(jié)數(shù) 加上 content-length
。
我們需要把每個(gè)被下載文件的總字節(jié)數(shù)存儲(chǔ)起來(lái),這里我們選擇使用plist文件來(lái)記載,plist文件包含一個(gè)字典。設(shè)置文件名為鍵值,已經(jīng)下載的文件字節(jié)數(shù)為值。
文件名為了防止重復(fù),這里我們?cè)O(shè)置文件名為下載url的hash
值,可以保證不重重。
實(shí)現(xiàn)代碼如下:
- (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
方法會(huì)在請(qǐng)求收到回應(yīng)的時(shí)候調(diào)用一次,我們可以在該方法中獲取回應(yīng)信息,取出content-length
字段。
3.封裝一個(gè)方法,實(shí)現(xiàn)下載進(jìn)度,成功,失敗提示
我們可以模仿AFNetwork
,把下載封裝到一個(gè)方法,然后使用不同的block
來(lái)實(shí)現(xiàn)下載進(jìn)度,成功,失敗后的回調(diào)。
定義如下:
-(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]; }
上面的三個(gè)block
都采用宏定義方式,這樣看起來(lái)比較簡(jiǎn)潔,具體代碼參考下面的完整代碼。
然后我們可以在NSURLSessionDataDelegate
的對(duì)應(yīng)的代理方法中去實(shí)現(xiàn)三個(gè)block
的調(diào)用,然后傳入相應(yīng)的參數(shù)。這樣當(dāng)其他人調(diào)用我們的方法,就可以在相應(yīng)的block
中實(shí)現(xiàn)回調(diào)。具體代碼參考下面的完整代碼
完整代碼實(shí)現(xiàn)
下面是完整的代碼實(shí)現(xiàn)
#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 () /** 下載任務(wù) */ @property (nonatomic, strong) NSURLSessionDataTask *task; /** session */ @property (nonatomic, strong) NSURLSession *session; /** 寫(xiě)文件的流對(duì)象 */ @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文件存儲(chǔ)已經(jīng)下載的文件大小 #define TotalLengthPlist [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"totalLength.plist"] // 文件的已被下載的大小 #define DownloadLength [[[NSFileManager defaultManager] attributesOfItemAtPath: FileStorePath error:nil][NSFileSize] integerValue] @implementation DownLoadManager #pragma mark - 創(chuàng)建單例 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 - 公開(kāi)方法 -(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(@"######文件已經(jīng)下載過(guò)了"); return nil; } // 創(chuàng)建請(qǐng)求 NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString: self.downLoadUrl]]; // 設(shè)置請(qǐng)求頭 // Range : bytes=xxx-xxx,從已經(jīng)下載的長(zhǎng)度開(kāi)始到文件總長(zhǎng)度的最后都要下載 NSString *range = [NSString stringWithFormat:@"bytes=%zd-", DownloadLength]; [request setValue:range forHTTPHeaderField:@"Range"]; // 創(chuàng)建一個(gè)Data任務(wù) _task = [self.session dataTaskWithRequest:request]; } return _task; } #pragma mark - <NSURLSessionDataDelegate> /** * 1.接收到響應(yīng) */ - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveResponse:(NSHTTPURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler { // 打開(kāi)流 [self.stream open]; /* (Content-Length字段返回的是服務(wù)器對(duì)每次客戶端請(qǐng)求要下載文件的大小) 比如首次客戶端請(qǐng)求下載文件A,大小為1000byte,那么第一次服務(wù)器返回的Content-Length = 1000, 客戶端下載到500byte,突然中斷,再次請(qǐng)求的range為 “bytes=500-”,那么此時(shí)服務(wù)器返回的Content-Length為500 所以對(duì)于單個(gè)文件進(jìn)行多次下載的情況(斷點(diǎn)續(xù)傳),計(jì)算文件的總大小,必須把服務(wù)器返回的content-length加上本地存儲(chǔ)的已經(jīng)下載的文件大小 */ self.totalLength = [response.allHeaderFields[@"Content-Length"] integerValue] + DownloadLength; // 把此次已經(jīng)下載的文件大小存儲(chǔ)在plist文件 NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithContentsOfFile: TotalLengthPlist]; if (dict == nil) dict = [NSMutableDictionary dictionary]; dict[ Filename] = @(self.totalLength); [dict writeToFile: TotalLengthPlist atomically:YES]; // 接收這個(gè)請(qǐng)求,允許接收服務(wù)器的數(shù)據(jù) completionHandler(NSURLSessionResponseAllow); } /** * 2.接收到服務(wù)器返回的數(shù)據(jù)(這個(gè)方法可能會(huì)被調(diào)用N次) */ - (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)dataTask didReceiveData:(NSData *)data { // 寫(xiě)入數(shù)據(jù) [self.stream write:data.bytes maxLength:data.length]; float progress = 1.0 * DownloadLength / self.totalLength; if (self.progressBlock) { self.progressBlock(progress); } // 下載進(jìn)度 } /** * 3.請(qǐng)求完畢(成功\失敗) */ - (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); } // 關(guān)閉流 [self.stream close]; self.stream = nil; // 清除任務(wù) self.task = nil; } } @end
如何調(diào)用
@interface ViewController () @end @implementation ViewController /** * 開(kāi)始下載 */ - (IBAction)start:(id)sender { // 啟動(dòng)任務(wù) 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
總結(jié)
這里只能實(shí)現(xiàn)單個(gè)任務(wù)下載,大家可以自己想想辦法,看如何實(shí)現(xiàn)多任務(wù)下載,并且實(shí)現(xiàn)斷點(diǎn)續(xù)傳功能。并且為了更加便于操作,建議把存儲(chǔ)信息換成使用數(shù)據(jù)庫(kù)存儲(chǔ)。以上就是這篇文章的全部?jī)?nèi)容了,希望對(duì)大家學(xué)習(xí)IOS開(kāi)發(fā)有所幫助。
- iOS實(shí)現(xiàn)文件切片儲(chǔ)存并且上傳(仿斷點(diǎn)續(xù)傳機(jī)制)
- iOS11 下載之?dāng)帱c(diǎn)續(xù)傳的bug的解決方法
- 總結(jié)iOS開(kāi)發(fā)中的斷點(diǎn)續(xù)傳與實(shí)踐
- iOS NSURLSessionDownloadTask實(shí)現(xiàn)文件斷點(diǎn)下載的方法
- iOS利用AFNetworking3.0——實(shí)現(xiàn)文件斷點(diǎn)下載
- iOS開(kāi)發(fā)-實(shí)現(xiàn)大文件下載與斷點(diǎn)下載思路
- iOS開(kāi)發(fā)網(wǎng)絡(luò)篇—實(shí)現(xiàn)大文件的多線程斷點(diǎn)下載
- iOS使用NSURLConnection實(shí)現(xiàn)斷點(diǎn)續(xù)傳下載
相關(guān)文章
詳解iOS應(yīng)用開(kāi)發(fā)中Core Data數(shù)據(jù)存儲(chǔ)的使用
這篇文章主要介紹了iOS應(yīng)用開(kāi)發(fā)中Core Data數(shù)據(jù)存儲(chǔ)的使用,Core Data可以看作是一個(gè)內(nèi)嵌型數(shù)據(jù)庫(kù)SQLite的iOS專(zhuān)用版本,需要的朋友可以參考下2016-02-02iOS 正則表達(dá)式判斷手機(jī)號(hào)碼、固話
本文主要介紹了iOS 正則表達(dá)式判斷手機(jī)號(hào)碼、固話,以及匹配是否是移動(dòng)/聯(lián)通/電信手機(jī)號(hào)的方法。具有很好的參考價(jià)值,下面跟著小編一起來(lái)看下吧2017-03-03iOS中UIImagePickerController圖片選取器的用法小結(jié)
UIImagePickerController平時(shí)就是用來(lái)做應(yīng)用中從相冊(cè)中選取圖片功能的,這里我們就來(lái)整理一下iOS中UIImagePickerController圖片選取器的用法小結(jié),需要的朋友可以參考下2016-05-05iOS開(kāi)發(fā)中UITableview控件的基本使用及性能優(yōu)化方法
這篇文章主要介紹了iOS開(kāi)發(fā)中UITableview控件的基本使用及性能優(yōu)化方法,代碼基于傳統(tǒng)的Objective-C,需要的朋友可以參考下2015-12-12