iOS開發(fā)ASIHttpRequest創(chuàng)建和執(zhí)行request
本文為大家介紹了iOS開發(fā)中ASIHttpRequest如何創(chuàng)建和執(zhí)行request,其中包括同步請求,異步請求,使用Block,使用隊列,取消異步請求等等內(nèi)容。
創(chuàng)建NSOperationQueue,這個Cocoa架構(gòu)的執(zhí)行任務(wù)(NSOperation)的任務(wù)隊列。我們通過ASIHTTPRequest.h的源碼可以看到,此類本身就是一個NSOperation的子類。也就是說它可以直接被放到任務(wù)隊列中并被執(zhí)行。
同步請求
同步請求會在當(dāng)前線程中執(zhí)行,使用error屬性來檢查結(jié)束狀態(tài)(要下載大文件,則需要設(shè)定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];
- }
- }
同步請求會阻塞主線程的執(zhí)行,這導(dǎo)致用戶界面不響應(yīng)用戶操作,任何動畫都會停止渲染。
異步請求
下面是最簡單的異步請求方法,這個request會在全局的NSOperationQueue中執(zhí)行,若要進(jìn)行更復(fù)雜的操作,我們需要自己創(chuàng)建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,以免出現(xiàn)retain循環(huán),因為request是會retain block的。
使用隊列
創(chuàng)建NSOperationQueue或者ASINetworkQueue隊列,我們還可以設(shè)定最大并發(fā)連接數(shù):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];
- }
如果不設(shè)定selector,那么系統(tǒng)會使用默認(rèn)的requestFinished: 和 requestFailed:方法
如果需要對隊列里面的每個request進(jìn)行區(qū)分,那么可以設(shè)定request的userInfo屬性,它是個NSDictionary,或者更簡單的方法是設(shè)定每個request的tag屬性,這兩個屬性都不會被發(fā)送到服務(wù)器。
不要使用request的URL來區(qū)分每個request,因為URL可能會改變(例如重定向),如果需要使用request的URL,使用[request originalURL],這個將永遠(yuǎn)返回第一個url。
對于ASINetworkQueue
ASINetworkQueue是NSOperationQueue的子類,提供更高級的特性(ASINetworkQueue的代理函數(shù)):
- requestDidStartSelector
當(dāng)一個request開始執(zhí)行時,這個代理函數(shù)會被調(diào)用。 - requestDidReceiveResponseHeadersSelector
當(dāng)隊列中的request收到服務(wù)器返回的頭信息時,這個代理函數(shù)會被調(diào)用。對于下載很大的文件,這個通常比整個request的完成要早。 - requestDidFinishSelector
當(dāng)每個request完成時,這個代理函數(shù)會被調(diào)用。 - requestDidFailSelector
當(dāng)每個request失敗時,這個代理函數(shù)會被調(diào)用。 - queueDidFinishSelector
當(dāng)隊列完成(無論request失敗還是成功)時,這個代理函數(shù)會被調(diào)用。
ASINetworkQueues與NSOperationQueues稍有不同,加入隊列的request不會立即開始執(zhí)行。如果隊列打開了進(jìn)度開關(guān),那么隊列開始時,會先對所有GET型request進(jìn)行一次HEAD請求,獲得總下載大小,然后真正的request才被執(zhí)行。
向一個已經(jīng)開始進(jìn)行的ASINetworkQueue 加入request會怎樣?
如果你使用ASINetworkQueue來跟蹤若干request的進(jìn)度,只有當(dāng)新的request開始執(zhí)行時,總進(jìn)度才會進(jìn)行自適應(yīng)調(diào)整(向后移動)。ASINetworkQueue不會為隊列開始后才加入的request進(jìn)行HEAD請求,所以如果你一次向一個正在執(zhí)行的隊列加入很多request,那么總進(jìn)度不會立即被更新。
如果隊列已經(jīng)開始了,不需要再次調(diào)用[queue go]。
當(dāng)ASINetworkQueue中的一個request失敗時,默認(rèn)情況下,ASINetworkQueue會取消所有其他的request。要禁用這個特性,設(shè)置 [queue setShouldCancelAllRequestsOnFailure:NO]。
ASINetworkQueues只可以執(zhí)行ASIHTTPRequest操作,二不可以用于通用操作。試圖加入一個不是ASIHTTPRequest的NSOperation將會導(dǎo)致拋出錯誤。
取消異步請求
取消一個異步請求(無論request是由[request startAsynchronous]開始的還是從你創(chuàng)建的隊列中開始的),使用[request cancel]即可。注意同步請求不可以被取消。
注意,如果你取消了一個request,那么這個request將會被視為請求失敗,并且request的代理或者隊列的代理的失敗代理函數(shù)將被調(diào)用。如果你不想讓代理函數(shù)被調(diào)用,那么將delegate設(shè)置為nil,或者使用clearDelegatesAndCancel方法來取消request。
clearDelegatesAndCancel 將會首先清除所有的代理和block。
當(dāng)使用ASINetworkQueue時,如果取消了隊列中的一個request,那么隊列中其他所有request都會被取消,可以設(shè)置shouldCancelAllRequestsOnFailure的值為NO來避免這個現(xiàn)象。
安全地控制delegate防止request完成之前代理被釋放
request并不retain它們的代理,所以有可能你已經(jīng)釋放了代理,而之后request完成了,這將會引起崩潰。大多數(shù)情況下,如果你的代理即將被釋放,你一定也希望取消所有request,因為你已經(jīng)不再關(guān)心它們的返回情況了。如此做:
- // 代理類的dealloc函數(shù)
- - (void)dealloc
- {
- [request clearDelegatesAndCancel];
- [request release];
- ...
- [super dealloc];
- }