ASIHttpRequest-創建和執行request

同步請求

同步請求會在當前線程中執行，使用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];
}