本文為大家介紹了發(fā)ASIHTTPRequest進(jìn)度追蹤的內(nèi)容，其中包括追蹤單個request的下載進(jìn)度,追蹤一系列request的下載進(jìn)度,追蹤單個request的上傳進(jìn)度,追蹤一系列request的上傳進(jìn)度,精確進(jìn)度條vs簡單進(jìn)度條,自定義進(jìn)度追蹤等等內(nèi)容。

每個ASIHTTPRequest有兩個delegate用來追蹤進(jìn)度：

downloadProgressDelegate (下載) 和 uploadProgressDelegate (上載)。

進(jìn)度delegate可以是NSProgressIndicators (Mac OS X) 或者 UIProgressViews (iPhone).ASIHTTPRequest會自適應(yīng)這兩個class的行為。你也可以使用自定義class作為進(jìn)度delegate，只要它響應(yīng)setProgress:函數(shù)。

• 如果你執(zhí)行單個request，那么你需要為該request設(shè)定upload/download進(jìn)度delegate
• 如果你在進(jìn)行多個請求，并且你想要追蹤整個隊列中的進(jìn)度，你必須使用ASINetworkQueue并設(shè)置隊列的進(jìn)度delegate
• 如果上述兩者你想同時擁有，恭喜你，0.97版以后的ASIHTTPRequest，這個可以有 ^ ^

IMPORTANT:如果你向一個要求身份驗證的網(wǎng)站上傳數(shù)據(jù)，那么每次授權(quán)失敗，上傳進(jìn)度條就會被重置為上一次的進(jìn)度值。因此，當(dāng)與需要授權(quán)的web服務(wù)器交互時，建議僅當(dāng)useSessionPersistence為YES時才使用上傳進(jìn)度條，并且確保你在追蹤大量數(shù)據(jù)的上傳進(jìn)度之前，先使用另外的request來進(jìn)行授權(quán)。 

追蹤小于128KB的數(shù)據(jù)上傳進(jìn)度目前無法做到，而對于大于128kb的數(shù)據(jù)，進(jìn)度delegate不會收到***個128kb數(shù)據(jù)塊的進(jìn)度信息。這是因為CFNetwork庫API的限制。我們曾向apple提交過bug報告（bug id 6596016），希望apple能修改CFNetwork庫以便實現(xiàn)上述功能。

2009-6-21：Apple的哥們兒們真棒！iPhone 3.0 SDK里，buffer大小已經(jīng)被減小到32KB了，我們的上傳進(jìn)度條可以更精確了。

追蹤單個request的下載進(jìn)度

這個例子中， myProgressIndicator是個 NSProgressIndicator.

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; 
[request setDownloadProgressDelegate:myProgressIndicator]; 
[request startSynchronous]; 
NSLog(@"Max: %f, Value: %f", [myProgressIndicator maxValue],[myProgressIndicator doubleValue]); 

追蹤一系列request的下載進(jìn)度

在這個例子中, myProgressIndicator 是個 UIProgressView, myQueue是個 ASINetworkQueue.

- (void)fetchThisURLFiveTimes:(NSURL *)url 
{ 
   [myQueue cancelAllOperations]; 
   [myQueue setDownloadProgressDelegate:myProgressIndicator]; 
   [myQueue setDelegate:self]; 
   [myQueue setRequestDidFinishSelector:@selector(queueComplete:)]; 
   int i; 
   for (i=0; i<5; i++) { 
      ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; 
      [myQueue addOperation:request]; 
   } 
   [myQueue go]; 
} 
  
- (void)queueComplete:(ASINetworkQueue *)queue 
{ 
   NSLog(@"Value: %f", [myProgressIndicator progress]); 
} 

這個例子中，我們已經(jīng)為ASINetworkQueues調(diào)用過[myQueue go]了。

追蹤單個request的上傳進(jìn)度

在這個例子中, myProgressIndicator 是個 UIProgressView。

ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:url]; 
[request setPostValue:@"Ben" forKey:@"first_name"]; 
[request setPostValue:@"Copsey" forKey:@"last_name"]; 
[request setUploadProgressDelegate:myProgressIndicator]; 
[request startSynchronous]; 
NSLog(@"Value: %f",[myProgressIndicator progress]); 

追蹤一系列request的上傳進(jìn)度

這個例子中, myProgressIndicator是個 NSProgressIndicator, myQueue是個ASINetworkQueue.

- (void)uploadSomethingFiveTimes:(NSURL *)url 
{ 
   [myQueue cancelAllOperations]; 
   [myQueue setUploadProgressDelegate:myProgressIndicator]; 
   [myQueue setDelegate:self]; 
   [myQueue setRequestDidFinishSelector:@selector(queueComplete:)]; 
   int i; 
   for (i=0; i<5; i++) { 
      ASIHTTPRequest *request = [ASIFormDataRequest requestWithURL:url]; 
      [request setPostBody:[@"Some data" dataUsingEncoding:NSUTF8StringEncoding]]; 
      [myQueue addOperation:request]; 
   } 
   [myQueue go]; 
} 
  
- (void)queueComplete:(ASINetworkQueue *)queue 
{ 
   NSLog(@"Max: %f, Value: %f", [myProgressIndicator maxValue],[myProgressIndicator doubleValue]); 
} 

精確進(jìn)度條vs簡單進(jìn)度條

ASIHTTPRequest提供兩種進(jìn)度條顯示，簡單進(jìn)度條和精確進(jìn)度條，使用ASIHTTPRequests 和ASINetworkQueues的showAccurateProgress 來控制。為一個request設(shè)置showAccurateProgress只會對該request有效。如果你為一個隊列設(shè)置showAccurateProgress，那么會影響隊列里所有的request。

簡單進(jìn)度條

當(dāng)使用簡單進(jìn)度條時，進(jìn)度條只會在一個request完成時才更新。對于單個request，這意味著你只有兩個進(jìn)度狀態(tài)：0%和100%。對于一個有5個request的隊列來說，有五個狀態(tài)：0%，25%，50%，75%，100%，每個request完成時，進(jìn)度條增長一次。

簡單進(jìn)度條（showAccurateProgress = NO）是ASINetworkQueue的默認(rèn)值，適用于大量小數(shù)據(jù)請求。

精確進(jìn)度條

當(dāng)使用精確進(jìn)度條時，每當(dāng)字節(jié)被上傳或下載時，進(jìn)度條都會更新。它適用于上傳/下載大塊數(shù)據(jù)的請求，并且會更好的顯示已經(jīng)發(fā)送/接收的數(shù)據(jù)量。

使用精確進(jìn)度條追蹤上傳會輕微降低界面效率，因為進(jìn)度delegate（一般是UIProgressViews 或NSProgressIndicators）會更頻繁地重繪。

使用精確進(jìn)度條追蹤下載會更影響界面效率，因為隊列會先為每個GET型request進(jìn)行HEAD請求，以便統(tǒng)計總下載量。強(qiáng)烈推薦對下載大文件的隊列使用精確進(jìn)度條，但是要避免對大量小數(shù)據(jù)請求使用精確進(jìn)度條。

精確進(jìn)度條（showAccurateProgress = YES）是以同步方式執(zhí)行的ASIHTTPRequest的默認(rèn)值。

自定義進(jìn)度追蹤

ASIProgressDelegate 協(xié)議定義了所有能更新一個request進(jìn)度的方法。多數(shù)情況下，設(shè)置你的uploadProgressDelegate或者 downloadProgressDelegate為NSProgressIndicator或者UIProgressView會很好。但是，如果你想進(jìn)行更復(fù)雜的追蹤，你的進(jìn)度delegate實現(xiàn)下列函數(shù)要比 setProgress: (iOS) 或者 setDoubleValue: / setMaxValue: (Mac)好：

這些函數(shù)允許你在實際量的數(shù)據(jù)被上傳或下載時更新進(jìn)度，而非簡單方法的0到1之間的數(shù)字。

downloadProgressDelegates方法

• request:didReceiveBytes: 每次request下載了更多數(shù)據(jù)時，這個函數(shù)會被調(diào)用（注意，這個函數(shù)與一般的代理實現(xiàn)的 request:didReceiveData:函數(shù)不同）。
• request:incrementDownloadSizeBy: 當(dāng)下載的大小發(fā)生改變時，這個函數(shù)會被調(diào)用，傳入的參數(shù)是你需要增加的大小。這通常發(fā)生在request收到響應(yīng)頭并且找到下載大小時。

uploadProgressDelegates方法

• request:didSendBytes: 每次request可以發(fā)送更多數(shù)據(jù)時，這個函數(shù)會被調(diào)用。注意：當(dāng)一個request需要消除上傳進(jìn)度時（通常是該request發(fā)送了一段數(shù)據(jù)，但是因為授權(quán)失敗或者其他什么原因?qū)е逻@段數(shù)據(jù)需要重發(fā)）這個函數(shù)會被傳入一個小于零的數(shù)字。