1. 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];
}