iOS開發ASIHttpRequest創建和執行request
本文為大家介紹了iOS開發中ASIHttpRequest如何創建和執行request,其中包括同步請求,異步請求,使用Block,使用隊列,取消異步請求等等內容。
創建NSOperationQueue,這個Cocoa架構的執行任務(NSOperation)的任務隊列。我們通過ASIHTTPRequest.h的源碼可以看到,此類本身就是一個NSOperation的子類。也就是說它可以直接被放到任務隊列中并被執行。
同步請求
同步請求會在當前線程中執行,使用error屬性來檢查結束狀態(要下載大文件,則需要設定downloadDestinationPath來保存文件到本地):
- - (IBAction)grabURL:(id)sender
- {
- NSURL *url = [NSURL URLWithString:@"http://www.dreamingwish.com"];
- ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
- [request startSynchronous];
- NSError *error = [request error];
- if (!error) {
- NSString *response = [request responseString];
- }
- }
同步請求會阻塞主線程的執行,這導致用戶界面不響應用戶操作,任何動畫都會停止渲染。
異步請求
下面是最簡單的異步請求方法,這個request會在全局的NSOperationQueue中執行,若要進行更復雜的操作,我們需要自己創建NSOperationQueue或者ASINetworkQueue,后面會講到。
- - (IBAction)grabURLInBackground:(id)sender
- {
- NSURL *url = [NSURL URLWithString:@"http://www.dreamingwish.com"];
- ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
- [request setDelegate:self];
- [request startAsynchronous];
- }
- - (void)requestFinished:(ASIHTTPRequest *)request
- {
- // Use when fetching text data
- NSString *responseString = [request responseString];
- // Use when fetching binary data
- NSData *responseData = [request responseData];
- }
- - (void)requestFailed:(ASIHTTPRequest *)request
- {
- NSError *error = [request error];
- }
使用block
在平臺支持情況下,ASIHTTPRequest1.8以上支持block。
- - (IBAction)grabURLInBackground:(id)sender
- {
- NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];
- __block ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
- [request setCompletionBlock:^{
- // Use when fetching text data
- NSString *responseString = [request responseString];
- // Use when fetching binary data
- NSData *responseData = [request responseData];
- }];
- [request setFailedBlock:^{
- NSError *error = [request error];
- }];
- [request startAsynchronous];
- }
注意,聲明request時要使用__block修飾符,這是為了告訴block不要retain request,以免出現retain循環,因為request是會retain block的。
使用隊列
創建NSOperationQueue或者ASINetworkQueue隊列,我們還可以設定最大并發連接數:maxConcurrentOperationCount
- - (IBAction)grabURLInTheBackground:(id)sender
- {
- if (![self queue]) {
- [self setQueue:[[[NSOperationQueue alloc] init] autorelease]];
- [self queue].maxConcurrentOperationCount = 4;
- }
- NSURL *url = [NSURL URLWithString:@"http://www.dreamingwish.com"];
- ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
- [request setDelegate:self];
- [request setDidFinishSelector:@selector(requestDone:)];
- [request setDidFailSelector:@selector(requestWentWrong:)];
- [[self queue] addOperation:request]; //queue is an NSOperationQueue
- }
- - (void)requestDone:(ASIHTTPRequest *)request
- {
- NSString *response = [request responseString];
- }
- - (void)requestWentWrong:(ASIHTTPRequest *)request
- {
- NSError *error = [request error];
- }
如果不設定selector,那么系統會使用默認的requestFinished: 和 requestFailed:方法
如果需要對隊列里面的每個request進行區分,那么可以設定request的userInfo屬性,它是個NSDictionary,或者更簡單的方法是設定每個request的tag屬性,這兩個屬性都不會被發送到服務器。
不要使用request的URL來區分每個request,因為URL可能會改變(例如重定向),如果需要使用request的URL,使用[request originalURL],這個將永遠返回第一個url。
對于ASINetworkQueue
ASINetworkQueue是NSOperationQueue的子類,提供更高級的特性(ASINetworkQueue的代理函數):
- requestDidStartSelector
當一個request開始執行時,這個代理函數會被調用。 - requestDidReceiveResponseHeadersSelector
當隊列中的request收到服務器返回的頭信息時,這個代理函數會被調用。對于下載很大的文件,這個通常比整個request的完成要早。 - requestDidFinishSelector
當每個request完成時,這個代理函數會被調用。 - requestDidFailSelector
當每個request失敗時,這個代理函數會被調用。 - queueDidFinishSelector
當隊列完成(無論request失敗還是成功)時,這個代理函數會被調用。
ASINetworkQueues與NSOperationQueues稍有不同,加入隊列的request不會立即開始執行。如果隊列打開了進度開關,那么隊列開始時,會先對所有GET型request進行一次HEAD請求,獲得總下載大小,然后真正的request才被執行。
向一個已經開始進行的ASINetworkQueue 加入request會怎樣?
如果你使用ASINetworkQueue來跟蹤若干request的進度,只有當新的request開始執行時,總進度才會進行自適應調整(向后移動)。ASINetworkQueue不會為隊列開始后才加入的request進行HEAD請求,所以如果你一次向一個正在執行的隊列加入很多request,那么總進度不會立即被更新。
如果隊列已經開始了,不需要再次調用[queue go]。
當ASINetworkQueue中的一個request失敗時,默認情況下,ASINetworkQueue會取消所有其他的request。要禁用這個特性,設置 [queue setShouldCancelAllRequestsOnFailure:NO]。
ASINetworkQueues只可以執行ASIHTTPRequest操作,二不可以用于通用操作。試圖加入一個不是ASIHTTPRequest的NSOperation將會導致拋出錯誤。
取消異步請求
取消一個異步請求(無論request是由[request startAsynchronous]開始的還是從你創建的隊列中開始的),使用[request cancel]即可。注意同步請求不可以被取消。
注意,如果你取消了一個request,那么這個request將會被視為請求失敗,并且request的代理或者隊列的代理的失敗代理函數將被調用。如果你不想讓代理函數被調用,那么將delegate設置為nil,或者使用clearDelegatesAndCancel方法來取消request。
clearDelegatesAndCancel 將會首先清除所有的代理和block。
當使用ASINetworkQueue時,如果取消了隊列中的一個request,那么隊列中其他所有request都會被取消,可以設置shouldCancelAllRequestsOnFailure的值為NO來避免這個現象。
安全地控制delegate防止request完成之前代理被釋放
request并不retain它們的代理,所以有可能你已經釋放了代理,而之后request完成了,這將會引起崩潰。大多數情況下,如果你的代理即將被釋放,你一定也希望取消所有request,因為你已經不再關心它們的返回情況了。如此做:
- // 代理類的dealloc函數
- - (void)dealloc
- {
- [request clearDelegatesAndCancel];
- [request release];
- ...
- [super dealloc];
- }