通读AFN②--AFN的上传和下载功能分析、SessionTask及相应的session代理方法的使用细节...
這一部分主要研究AFN的上傳和下載功能，中間涉及到各種NSURLSessionTask的一些創(chuàng)建的解析和HTTPSessionManager對(duì)RESTful風(fēng)格的web應(yīng)用的支持，同時(shí)會(huì)穿插一點(diǎn)NSURLSession代理方法被調(diào)用的時(shí)機(jī)和對(duì)上傳的數(shù)據(jù)的序列化的步驟。
本文主要講解的是上傳和下載的代碼實(shí)現(xiàn)細(xì)節(jié)，不會(huì)考慮上傳過程中的安全性問題。
文件的上傳和下載同時(shí)也包括普通的數(shù)據(jù)請(qǐng)求說說到底都是使用了系統(tǒng)的NSURLSession類創(chuàng)建對(duì)應(yīng)的Task，然后執(zhí)行，為了更好得理解，我們先理清一下NSURLSessionTask類以及它的子類、NSURLSessionTaskDelegate協(xié)議和它的子協(xié)議之間的關(guān)系，以及各種代理方法調(diào)用的時(shí)機(jī)。
先看一張圖：
其中的調(diào)用是指，task在resume之后會(huì)調(diào)用的Session對(duì)應(yīng)的代理方法聲明在的協(xié)議，例如：
當(dāng)執(zhí)行一個(gè)NSURLSessionDataTask類型的任務(wù)resume之后，負(fù)責(zé)創(chuàng)建它的session將會(huì)調(diào)用在NSURLSessionDataDelegate中定義的幾個(gè)方法:
由于NSURLSessionDataDelegate協(xié)議遵守了NSURLSessionTaskDelegate和NSURLSessionDelegate，所以也會(huì)調(diào)用這樣幾個(gè)方法：
// 在NSURLSessionDelegate中聲明的 - URLSession: didBecomeInvalidWithError: - URLSession: didReceiveChallenge: completionHandler: - URLSessionDidFinishEventsForBackgroundURLSession:// 在NSURLSessionTaskDelegate中聲明的 - URLSession: task: willPerformHTTPRedirection: newRequest: completionHandler: - URLSession: task: didReceiveChallenge: completionHandler: - URLSession: task: needNewBodyStream: - URLSession: task: didSendBodyData: totalBytesSent: totalBytesExpectedToSend: - URLSession: task: didCompleteWithError:實(shí)際上你無法通過session來創(chuàng)建NSURLSessionTask，只能創(chuàng)建它的子類來使用，iOS并沒有提供可以直接創(chuàng)建它的方法:
1.不可能通過alloc init創(chuàng)建 ，因?yàn)閯?chuàng)建之后 無法給request屬性(readonly)賦值，網(wǎng)絡(luò)請(qǐng)求無法進(jìn)行。
2.NSURLSession、NSURLSession(NSURLSessionAsynchronousConvenience) 沒有提供直接創(chuàng)建的方法。
或許apple本來就打算將這個(gè)類設(shè)計(jì)為抽象類，而只能使用繼承它的類。
而只要是使用了session類進(jìn)行創(chuàng)建任何一個(gè)dataTask、uploadTask或者是downloadTask就會(huì)調(diào)用在NSURLSessionDelegate中和NSURLSessionTaskDelegate中聲明的代理方法,這些代理方法大都是進(jìn)行網(wǎng)絡(luò)請(qǐng)求的配置，少部分涉及到數(shù)據(jù)處理，而子協(xié)議NSURLSessionDataDelegate、NSURLSessionDownloadDelegate和NSURLSessionSteamDelegate都是具體的數(shù)據(jù)處理方法。
經(jīng)過一些簡單的測試：看看一些方法的調(diào)用順序，使用dataTask進(jìn)行一個(gè)普通的網(wǎng)絡(luò)請(qǐng)求：
如果使用的是GET請(qǐng)求，或者使用的是POST請(qǐng)求、但是HTTPBody沒有數(shù)據(jù)，主要調(diào)用兩個(gè)代理方法：
如果是POST請(qǐng)求，并且HTTPBody中帶有數(shù)據(jù)，那么主要調(diào)用以下幾個(gè)方法(實(shí)際上不管創(chuàng)建的任務(wù)是dataTask或是uploadTask都是這樣，畢竟uploadTask是繼承自dataTask的)：
- URLSession: task: didSendBodyData: totalBytesSent: totalBytesExpectedToSend: // 當(dāng)HTTPBody中有數(shù)據(jù)時(shí)調(diào)用 - URLSession: dataTask: didReceiveData: // 同上 - URLSession: task: didCompleteWithError: // 同上當(dāng)進(jìn)行一些下載操作，使用downloadTask的時(shí)候：
- URLSession: downloadTask: didWriteData: totalBytesWritten: totalBytesExpectedToWrite: // 間歇性調(diào)用 - URLSession: downloadTask: didFinishDownloadingToURL: // 下載完成時(shí)調(diào)用 - URLSession: task: didCompleteWithError: // 本次網(wǎng)絡(luò)訪問完成時(shí)調(diào)用 在上面的方法調(diào)用之后調(diào)用可以發(fā)現(xiàn)，但凡是session進(jìn)行的網(wǎng)絡(luò)請(qǐng)求都會(huì)最終調(diào)用- URLSession: task: didCompleteWithError:,而在在之前調(diào)用的代理方法，會(huì)因request是否攜帶數(shù)據(jù)，訪問完成的時(shí)候服務(wù)端是否有response的數(shù)據(jù)，還有使用的task的類型會(huì)有一些差別。下面會(huì)針對(duì)uploadTask的使用和downloadTask的使用細(xì)說這些差別，以及介紹一些實(shí)現(xiàn)上傳和下載的具體方案。
第二部分 上傳
使用上傳歸根結(jié)底都會(huì)使用apple的uploadTask，翻看AFN的源碼(僅僅是session部分)也都是使用了蘋果的三個(gè)創(chuàng)建uploadTask的方法完成的。
apple的三個(gè)方法都是一個(gè)思路：將要上傳的文件的二進(jìn)制寫入到HTTPBody中，
按照有沒有使用Form可以分為兩類：
1.沒有使用form
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromFile:(NSURL *)fileURL; - (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromData:(NSData *)bodyData;2.使用了form
- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request;下面分別介紹一下：
不使用表單的情況
AFN沒有使用html表單直接上傳的方式比較簡單，實(shí)現(xiàn)上是直接調(diào)用了apple的- uploadTaskWithRequest: fromFile:方法或者- uploadTaskWithRequest: fromData:，關(guān)于蘋果的這兩個(gè)方法，蘋果給出這樣的文檔
創(chuàng)建一個(gè)任務(wù)，這個(gè)任務(wù)能對(duì)指定的URLRquest對(duì)象執(zhí)行HTTP請(qǐng)求和上傳提供的數(shù)據(jù)。
對(duì)于request的參數(shù)有一點(diǎn)需要注意的是：它的body stream和body data會(huì)被忽略，只使用fromData參數(shù)提供的數(shù)據(jù)。對(duì)于request對(duì)象還有一個(gè)要求，必須是包含了request body，因此HTTP方法可以是POST或者PUT，另外可以使用HTTP的RequestHeader提供一些上傳的元數(shù)據(jù)，如文件名字等。其實(shí)這兩個(gè)方法內(nèi)部的實(shí)現(xiàn)中，是將要上傳的數(shù)據(jù)覆蓋寫入到了HTTPBody中。
AFNURLSessionManager對(duì)上面兩個(gè)蘋果的方法進(jìn)行了再一次的封裝，這個(gè)封裝就是將代理方法的處理交給了AFURLSessionManagerTaskDelegate類，同時(shí)將傳入的進(jìn)度NSProgress對(duì)象的指針指向了AFURLSessionManagerTaskDelegate對(duì)象的屬性progress，將task處理完成的回調(diào)賦給它的屬性AFURLSessionTaskCompletionHandler。
如果按照這種方式進(jìn)行文件上傳，可以按照如下方式使用AFN：
// 文件上傳,不使用表單(只能上傳單個(gè)文件),需要服務(wù)端的配合： // 1.服務(wù)端從HTTPBody得到文件內(nèi)容的二進(jìn)制 // 2.將二進(jìn)制存入文件中，并命名// 這個(gè)方法內(nèi)部直接使用apple的uploadTaskWithRequest創(chuàng)建任務(wù)， uploadTask具體的實(shí)現(xiàn)是： // 將文件的二進(jìn)制寫入到HTTPBody中 - (void)uploadFileNoFormWithURLString:(NSString *)urlString fromFile:(NSURL *)fileURL orFromData:(NSData *)bodyData progress:(NSProgress * __autoreleasing *)progress success:(void(^)(id responseObject))success failure:(void(^)(NSError *error))failure {AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];NSURL *url = [NSURL URLWithString:urlString];NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];request.HTTPMethod = @"POST"; // 必須要使用POST 否則會(huì)使用默認(rèn)的GET， 這樣服務(wù)器得到的input和HTTPBody內(nèi)容不同，這是因?yàn)槭褂眠@種方式上傳文件實(shí)際上是將文件的二進(jìn)制寫入到HTTPBody中。void (^completionBlock)(id responseObject, NSError *error) = ^(id responseObject, NSError *error) {if (error) {if (failure) {failure(error);}} else {if (success) {success(responseObject);}}};// 這里實(shí)際調(diào)用的URLSessionManager的方法，而不是HTTPSessionManager的方法if (fileURL) {[[manager uploadTaskWithRequest:request fromFile:fileURL progress:progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {completionBlock(responseObject, error);}] resume];return;}if (bodyData) {[[manager uploadTaskWithRequest:request fromData:bodyData progress:progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {completionBlock(responseObject, error);}] resume];}return; }使用表單的情況
使用表單其實(shí)是對(duì)HTTPBody數(shù)據(jù)格式進(jìn)行改造，類似于html中使用表單控件上傳，同樣的在底層上也是模擬html表單上傳數(shù)據(jù)的格式。經(jīng)過這樣的模擬之后，服務(wù)端接收到的每個(gè)文件對(duì)應(yīng)到一個(gè)表單域(field)的值，這樣方便了服務(wù)端的處理和前臺(tái)的html頁面的統(tǒng)一。
AFN使用這種方式上傳的實(shí)現(xiàn)依靠的是apple的- uploadTaskWithStreamedRequest:這個(gè)方法,對(duì)于這方法，文檔中有這樣的說明：
用一個(gè)指定的request創(chuàng)建upload task。之前的request的body stream數(shù)據(jù)會(huì)被忽略，如何需要上傳數(shù)據(jù)調(diào)用URLSession:task:needNewBodyStream:方法。也就是說在這個(gè)方法中設(shè)置的request的HTTPBody和HTTPBodyStream會(huì)被忽略，而真正上傳的數(shù)據(jù)是從代理方法URLSession:task:needNewBodyStream:中取得的。
AFN的做法是：在AFHTTPRequestSerializer對(duì)象的multipartFormRequestWithMethod: URLString: parameters: constructingBodyWithBlock: error:方法中將要上傳的數(shù)據(jù)組裝為NSInputStream對(duì)象(其實(shí)是NSInputStream的子類AFMultipartBodyStream)并設(shè)置為request的HTTPBodyStream屬性，然后返回這個(gè)request，當(dāng)真正執(zhí)行到URLSession:task:needNewBodyStream:方法時(shí)，會(huì)從request中將這個(gè)InputStream取出，然后復(fù)制，最終傳遞給用來接收它的回調(diào)completionHandler。
- (void)URLSession:(NSURLSession *)sessiontask:(NSURLSessionTask *)taskneedNewBodyStream:(void (^)(NSInputStream *bodyStream))completionHandler {NSInputStream *inputStream = nil;if (self.taskNeedNewBodyStream) {inputStream = self.taskNeedNewBodyStream(session, task);} else if (task.originalRequest.HTTPBodyStream && [task.originalRequest.HTTPBodyStream conformsToProtocol:@protocol(NSCopying)]) {inputStream = [task.originalRequest.HTTPBodyStream copy];}if (completionHandler) {completionHandler(inputStream);} }這里AFN拼接表單域的方式和html在瀏覽器中的行為一致，AFN的拼接方式完全按照瀏覽器的方式模擬了這個(gè)過程，主要通過兩個(gè)類來實(shí)現(xiàn)，用于拼接的AFStreamingMultipartFormData類和用于Strea轉(zhuǎn)換的AFMultipartBodyStream類。
1.首先是將parameter參數(shù)轉(zhuǎn)為AFQueryStringPair數(shù)組，并將每個(gè)AFQueryStringPair對(duì)象的元素轉(zhuǎn)為filed和value的二進(jìn)制形式，然后使用AFStreamingMultipartFormData對(duì)象的- appendPartWithFormData: name:方法將它們拼接為下面格式（boundary生成之后的boundary）
--boundary Content-Disposition: form-data; name="xx";二進(jìn)制data2.將parameter的傳遞的參數(shù)拼接完成后拼接文件：
利用request中傳遞過來的block繼續(xù)給上面的AFStreamingMultipartFormData兌現(xiàn)追加內(nèi)容：使用-appendPartWithFileURL: name: error:方法拼接文件，拼接為如下格式：
最后還得加上頭部
Content-Type:multipart/form-data; boundary=生成后的boundary還有尾部
--生成后的boundary--這是最終拼接的結(jié)果，實(shí)際上AFN的拼接過程比這個(gè)要復(fù)雜，它并沒有將最終形式的'串'直接拼接出來，而是將每一個(gè)部分轉(zhuǎn)為一個(gè)AFHTTPBodyPart對(duì)象，存儲(chǔ)到AFStreamingMultipartFormData對(duì)象的屬性bodyStream中，bodyStream是一個(gè)AFMultipartBodyStream對(duì)象，使用的是的- appendHTTPBodyPart:方法將AFHTTPBodyPart存儲(chǔ)到了它自己的可變數(shù)組屬性HTTPBodyParts中，最后在AFStreamingMultipartFormData對(duì)象的以下方法完成拼接：
- (NSMutableURLRequest *)requestByFinalizingMultipartFormData {if ([self.bodyStream isEmpty]) {return self.request;}// Reset the initial and final boundaries to ensure correct Content-Length[self.bodyStream setInitialAndFinalBoundaries];[self.request setHTTPBodyStream:self.bodyStream];[self.request setValue:[NSString stringWithFormat:@"multipart/form-data; boundary=%@", self.boundary] forHTTPHeaderField:@"Content-Type"];[self.request setValue:[NSString stringWithFormat:@"%llu", [self.bodyStream contentLength]] forHTTPHeaderField:@"Content-Length"];return self.request; }可以看到bodyStream在加了頭部和尾部之后賦值給了request，這里最關(guān)鍵的就是AFMultipartBodyStream(bodyStream的類型)已經(jīng)重寫了InputStream的read:maxLength:和getBuffer:length:連個(gè)方法，這樣當(dāng)bodyStream被讀取的時(shí)候會(huì)按照這兩個(gè)方法的實(shí)現(xiàn)，按照剛才介紹的那種形式將數(shù)據(jù)拼接起來。
介紹完了這些，我們看一下使用這種方案進(jìn)行上傳文件的常用代碼：
// 多文件上傳，使用POST方法，使用的是表單的方式，需要服務(wù)端的腳本支持 // 使用表單上傳，將文件作為表單的中的一個(gè)field - (void)uploadFileUseFormWithURLString:(NSString *)urlString parameter:(id)parameter constructingBodyWithBlock:(void (^)(id <AFMultipartFormData> formData))block progress:(NSProgress * __autoreleasing *)progress success:(void(^)(id responseObject))success failure:(void(^)(NSError *error))failure {AFHTTPSessionManager *mgr = [AFHTTPSessionManager manager];[mgr POST:urlString parameters:parameter constructingBodyWithBlock:block success:^(NSURLSessionDataTask *task, id responseObject) {if (success) {success(responseObject);}} failure:^(NSURLSessionDataTask *task, NSError *error) {if (failure) {failure(error);}}]; }// 也可以使用提前組裝好request的方法 - (void)uploadFileUseFormWithStreamedRequest:(NSURLRequest *)urlRequest progress:(NSProgress * __autoreleasing *)progress success:(void(^)(id responseObject))success failure:(void(^)(NSError *error))failure {AFHTTPSessionManager *mgr = [AFHTTPSessionManager manager];[[mgr uploadTaskWithStreamedRequest:urlRequest progress:progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {if (error) {if (failure) {failure(error);}} else {if (success) {success(responseObject);}}}] resume]; }這里提供了兩種方案，底層代碼完全一樣，第一種是在使用時(shí)拼接表單，第二種是將表單和parameter組裝到request之后直接調(diào)用，調(diào)用方法如下：
// 對(duì)第一種方式的調(diào)用 NSString *uploadURLString = @"http://127.0.0.1/post/upload-multipart.php"; NSDictionary *parameter = @{@"username": @"Mike"}; NSProgress *progress1 = nil;[self uploadFileUseFormWithURLString:uploadURLString parameter:parameter constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {NSString *documentFolder = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];NSURL *fileURL = [NSURL fileURLWithPath:[documentFolder stringByAppendingPathComponent:@"1.txt"]];[formData appendPartWithFileURL:fileURL name:@"userfile[]" error:NULL];NSURL *fileURL1 = [NSURL fileURLWithPath:[documentFolder stringByAppendingPathComponent:@"2.jpg"]];[formData appendPartWithFileURL:fileURL1 name:@"userfile[]" fileName:@"aaa.jpg" mimeType:@"image/jpeg" error:NULL]; } progress:&progress1 success:^(id responseObject) {NSLog(@"%@", responseObject); } failure:nil];// 對(duì)第二種方式(預(yù)先組裝request)的調(diào)用 NSString *documentFolder = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; NSURL *fileURL1 = [NSURL fileURLWithPath:[documentFolder stringByAppendingPathComponent:@"1.txt"]]; NSURL *fileURL2 = [NSURL fileURLWithPath:[documentFolder stringByAppendingPathComponent:@"2.jpg"]];NSMutableURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:uploadURLString parameters:parameter constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {[formData appendPartWithFileURL:fileURL1 name:@"userfile[]" fileName:@"1.txt" mimeType:@"text/plain" error:nil];[formData appendPartWithFileURL:fileURL2 name:@"userfile[]" fileName:@"aaa.jpg" mimeType:@"image/jpeg" error:nil]; } error:nil];NSProgress *progress2 = nil; [self uploadFileUseFormWithStreamedRequest:request progress:&progress2 success:^(id responseObject) {NSLog(@"%@", responseObject); } failure:nil];兩種方法的底層實(shí)現(xiàn)和結(jié)果是完全一致的。
針對(duì)RESTful Web應(yīng)用的文件上傳
使用RESTful風(fēng)格的應(yīng)用，默認(rèn)對(duì)網(wǎng)絡(luò)資源增、刪、改、查對(duì)應(yīng)于HTTP的PUT、DELETE、POST、GET方法。RESTful更多的是強(qiáng)調(diào)服務(wù)端的技術(shù)，而對(duì)于iOS客戶端而言，網(wǎng)絡(luò)訪問的代碼變動(dòng)不是特別大，例如針對(duì)文件上傳，服務(wù)器要具有處理文件上傳的能力，而且不用像html表單那樣針對(duì)特定的頁面定制具有專一功能的處理腳本，對(duì)于這種需求，也許webDav是一個(gè)很好的工具，當(dāng)然web服務(wù)端也可能會(huì)針對(duì)各自的語言和平臺(tái)使用各自的文件處理中間件，但服務(wù)端的處理不是本文的重點(diǎn)，不再多說。另外，針對(duì)文件上傳服務(wù)端可能要做一些用戶驗(yàn)證，iOS客戶端就要做一些配合了。
以'我要在http://127.0.0.1/uploads這個(gè)url映射的目錄下放置一個(gè)文件名為12345.png的圖片文件'為例，當(dāng)我要進(jìn)行的操作已經(jīng)能用自然語言表達(dá)時(shí)，便可以以REST的思路來寫代碼了，那么：
我要使用的HTTP方法是PUT
我要操作的url為http://127.0.0.1/uploads
我會(huì)寫一個(gè)方法將文件名傳入，將文件的URL或者二進(jìn)制傳入,如下：
調(diào)用也是非常的簡單:
NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"1.png"]; NSURL *fileURL = [NSURL fileURLWithPath:filePath]; NSProgress *progress = nil; [self uploadFileUseRESTWithURLString:@"http://127.0.0.1/uploads" rename:@"12345.png" fromFile:fileURL orFromData:nil progress:&progress success:^(id responseObject) {NSLog(@"%@", responseObject); } failure:nil];第三部分 下載
AFN使用的下載同樣是調(diào)用了apple提供的方法:
- downloadTaskWithRequest: - downloadTaskWithURL: - downloadTaskWithResumeData:毫無疑問的是使用url最簡單了，畢竟大部分的下載是無需構(gòu)建request的。AFN使用名字相似的方法對(duì)系統(tǒng)方法進(jìn)行的一層包裝，通過sessionManager統(tǒng)一管理task。
例如完成一個(gè)簡單的下載任務(wù)：
好吧，那段進(jìn)行urlEncode的代碼確實(shí)礙眼。看一下下載的功能非常簡單，只要使用幾行代碼就完成了，這里有一個(gè)調(diào)用并獲取進(jìn)度的示例：
NSString *urlString = @"http://127.0.0.1/static/功夫熊貓.mp4"; NSProgress *progress = nil; [self downloadWithURLString:urlString progress:&progress completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {NSLog(@"%@", error); }]; [progress addObserver:self forKeyPath:@"completedUnitCount" options:NSKeyValueObservingOptionNew context:nil];}- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context {if ([object isKindOfClass:[NSProgress class]]) {NSProgress *p = object;NSLog(@"已完成大小:%lld 總大小:%lld", p.completedUnitCount, p.totalUnitCount);NSLog(@"進(jìn)度:%0.2f%%", p.fractionCompleted * 100);} }可以利用這種方式來觀察進(jìn)度,它的原理是將外部傳來的NSProgress指針指向AFURLSessionManagerTaskDelegate對(duì)象的progress屬性，AFURLSessionManagerTaskDelegate對(duì)象會(huì)在- URLSession: downloadTask: didWriteData: totalBytesWritten: totalBytesExpectedToWrite:方法中改變自身的progress屬性值，這是外部的Progress的值也就改變了。
也可以使用URLSessionManager的downloadProgressForTask:方法獲取指定task的完成進(jìn)度，不過這要進(jìn)行對(duì)task的統(tǒng)一管理。
在開發(fā)中經(jīng)常會(huì)遇到下載管理，UI要獲取到下載的進(jìn)度，通常有兩種方法：
1.下載器管理進(jìn)度，進(jìn)度改變發(fā)送通知，監(jiān)聽進(jìn)度改變的UI控件更新(非常消耗性能)
2.UI控件主動(dòng)獲取任務(wù)管理器中的任務(wù)，間隔性地獲取進(jìn)度。
說到NSURLSessionDownloadDelegate中聲明的三個(gè)方法：
- URLSession:session downloadTask:downloadTask didFinishDownloadingToURL: // 在下載完成的時(shí)候調(diào)用 - URLSession: downloadTask: didWriteData: totalBytesWritten: totalBytesExpectedToWrite: // 在下載的過程中間歇性調(diào)用 - URLSession: downloadTask: didResumeAtOffset: expectedTotalBytes:對(duì)于第三個(gè)方法到底什么時(shí)候調(diào)用，就不得不說一下使用NSURLSession的- downloadTaskWithResumeData:方法創(chuàng)建downloadTask了。
這個(gè)方法用resumeData創(chuàng)建一個(gè)downloadTask，如果downloadTask不能被成功地恢復(fù), URLSession:task:didCompleteWithError: 會(huì)被調(diào)用。
說白了它被用來恢復(fù)已經(jīng)暫停的downloadTask，那么downloadTask如何暫停呢，畢竟都沒有被暫停何來恢復(fù)。可以主動(dòng)調(diào)用downloadTask的一個(gè)對(duì)象方法：
這個(gè)方法會(huì)讓downloadTask暫停，它接收一個(gè)回調(diào)，在任務(wù)暫停之后調(diào)用，一般在這個(gè)回調(diào)內(nèi)部記錄一下恢復(fù)點(diǎn)的數(shù)據(jù)resumeData，resumeData參數(shù)是將來用來繼續(xù)的參數(shù)。resumeData只是一個(gè)chunk，而不是已經(jīng)下載的全部數(shù)據(jù)，因此無法通過它實(shí)現(xiàn)斷點(diǎn)續(xù)傳，只能實(shí)現(xiàn)簡單的暫停和繼續(xù)，并且要保證通過resume創(chuàng)建downloadTask時(shí)使用的session和創(chuàng)建被取消的downloadTask時(shí)使用的session是同一個(gè)，也就是所謂的session沒有離線 。
這是一些實(shí)現(xiàn)暫停和繼續(xù)的示例代碼：
那么以AFN的方式，就得保存manager，因?yàn)橹灰猰anager沒有改變session就沒有改變，同時(shí)應(yīng)該將下載的任務(wù)添加到一個(gè)任務(wù)管理器中，對(duì)任務(wù)進(jìn)行統(tǒng)一的調(diào)配，這樣就可以使用使用下面的步驟進(jìn)行任務(wù)的暫停和繼續(xù)：
1.先取得downloadTask調(diào)用它的cancelByProducingResumeData:將resumeData保存起來
2.需要繼續(xù)的時(shí)候使用創(chuàng)建了上面的dataTask的manager和保存的resumeData進(jìn)行恢復(fù),manager調(diào)用downloadTaskWithResumeData:就可以。
轉(zhuǎn)載于:https://www.cnblogs.com/Mike-zh/p/5172389.html
總結(jié)
以上是生活随笔為你收集整理的通读AFN②--AFN的上传和下载功能分析、SessionTask及相应的session代理方法的使用细节...的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： Android 关于“NetworkOn
- 下一篇： kongge