添加類庫及ASIHTTPREQUEST簡介

官方網站: http://allseeing-i.com/ASIHTTPRequest/ 。可以從上面下載到最新源碼,以及獲取到相關的資料。

使用iOS SDK中的HTTP網絡請求API,相當的複雜,調用很繁瑣,ASIHTTPRequest就是一個對CFNetwork API進行了封裝,並且使用起來非常簡單的一套API,用Objective-C編寫,可以很好的應用在Mac OS X系統和iOS平臺的應用程序中。ASIHTTPRequest適用於基本的HTTP請求,和基於REST的服務之間的交互。

ASIHTTPRequest功能很強大,主要特色如下:

  • l 通過簡單的接口,即可完成向服務端提交數據和從服務端獲取數據的工作
  • l 下載的數據,可存儲到內存中或直接存儲到磁盤中
  • l 能上傳本地文件到服務端
  • l 可以方便的訪問和操作請求和返回的Http頭信息
  • l 可以獲取到上傳或下載的進度信息,爲應用程序提供更好的體驗
  • l 支持上傳或下載隊列,並且可獲取隊列的進度信息
  • l 支持基本、摘要和NTLM身份認證,在同一會話中授權憑證會自動維持,並且可以存儲在Keychain(Mac和iOS操作系統的密碼管理系統)中
  • l 支持Cookie
  • l 當應用(iOS 4+)在後臺運行時,請求可以繼續運行
  • l 支持GZIP壓縮數據
  • l 內置的ASIDownloadCache類,可以緩存請求返回的數據,這樣即使沒有網絡也可以返回已經緩存的數據結果
  • l ASIWebPageRequest –可以下載完整的網頁,包括包含的網頁、樣式表、腳本等資源文件,並顯示在UIWebView /WebView中。任意大小的頁面都可以無限期緩存,這樣即使沒有網絡也可以離線瀏覽
  • l 支持客戶端證書
  • l 支持通過代理髮起Http請求
  • l 支持帶寬限制。在iOS平臺,可以根據當前網絡情況來自動決定是否限制帶寬,例如當使用WWAN(GPRS/Edge/3G)網絡時限制,而當使用WIFI時不做任何限制
  • l 支持斷點續傳
  • l 支持同步和異步請求
2.1.1安裝說明

如果想在iOS項目中使用ASIHTTPRequest,需要在項目中進行簡單的配置,步驟如下:

1) 添加文件

往一個Xcode項目中添加第三方類庫文件,有兩種方式:

1. 第一種方式,在Finder中打開需要添加到文件或文件夾,在Xcode中打開要添加文件的項目,然後選中要添加的文件或文件夾,將它從Finder中拖到Xcode中,然後釋放。在彈出的對話框中,如果文件已經拷貝到了項目文件目錄中,則不需要選中“Copy items”的複選框;如果文件沒有拷貝到項目文件目錄,就需要選中“Copy items”的複選框,這樣Xcode會自動把文件複製到項目文件目錄下。如下圖所示:
clip_image002
clip_image004

2. 第二種方式,在Xcode中,在要添加文件的分組下點右鍵,選中“Add Files to “My Project”…”菜單,在彈出的文件瀏覽對話框中選中要添加到文件或文件夾。如果要添加文件已經拷貝到了項目文件目錄中,則不需要選中“Copy items”的複選框;如果文件沒有拷貝到項目文件目錄,就需要選中“Copy items”的複選框,這樣Xcode會自動把文件複製到項目文件目錄下。如下圖所示:
clip_image006
clip_image008

根據上面的說明,添加ASIHTTPRequest相關文件到Xcode項目中,所需文件列表如下:

ASIHTTPRequestConfig.h

ASIHTTPRequestDelegate.h

ASIProgressDelegate.h

ASICacheDelegate.h

ASIHTTPRequest.h

ASIHTTPRequest.m

ASIDataCompressor.h

ASIDataCompressor.m

ASIDataDecompressor.h

ASIDataDecompressor.m

ASIFormDataRequest.h

ASIInputStream.h

ASIInputStream.m

ASIFormDataRequest.m

ASINetworkQueue.h

ASINetworkQueue.m

ASIDownloadCache.h

ASIDownloadCache.m

ASIAuthenticationDialog.h

ASIAuthenticationDialog.m

Reachability.h (在源碼的 External/Reachability 目錄下)

Reachability.m (在源碼的 External/Reachability 目錄下)

2) 鏈接相關類庫

1. 選中項目

2. 選中目標

3. 跳轉到“Build Phases”標籤

4. 展開“Link Binary With Libraries”分組

5. 點擊“+”添加類庫

如下圖所示:

clip_image010

6. 從列表中選擇CFNetwork.framework,然後點擊“Add”按鈕。

clip_image012

7. 按照上一步相同的方法添加:SystemConfiguration.framework, MobileCoreServices.framework,CoreGraphics.framework和libz.1.2.3.dylib這幾個類庫。

8. 添加完後,可以將添加好的一起類庫拖到Xcode項目的Frameworks目錄下
clip_image014

2.1.2使用說明

ASIHTTPRequest有很多功能,所有功能說明都可以在其官方網站的相關文檔中查到,限於篇幅,本章僅簡單介紹一下如何使用ASIHTTPRequest來進行同步Http請求和異步Http請求。在後面的章節中,我們還會用到它的一些其他功能。

在使用ASIHTTPRequest之前,請確認已經正確安裝,然後在需要應用它的代碼文件頭部,加入:

#import “ASIHTTPRequest.h”

這樣就可以在代碼中使用ASIHTTPRequest相關的類。

創建一個同步請求

這是ASIHTTPRequest最簡單的一種使用模式,發送startSynchronous消息後即開始在同一線程中執行HTTP請求,線程將一直等待直到請求結束(請求成功或者失敗)。通過檢查error屬性可以判斷請求是否成功或者有錯誤發生。

要獲取返回的文本信息,調用responseString方法。如果下載的是二進制文件,例如圖片、MP3,則調用responseData方法,可以得到一個NSData對象。

- (IBAction)grabURL:(id)sender

{

NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

[request startSynchronous];

NSError *error = [request error];

if (!error) {

NSString *response = [request responseString];

}

}

一般情況下,應該優先使用異步請求代替同步請求,當在主線程中使用ASIHTTPRequest同步請求,應用程序的界面會鎖定,無法進行任何操作,直到請求完成。

創建一個異步請求

上例中的同步請求,如果換成異步方式來調用,請求是在後臺線程中運行,當請求執行完後再通知調用的線程。這樣不會導致主線程進行網絡請求時,界面被鎖定等情況。

- (IBAction)grabURLInBackground:(id)sender

{

NSURL *url = [NSURL URLWithString:@"http://allseeing-i.com"];

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];

[request setDelegate:self];

[request startAsynchronous];

}

- (void)requestFinished:(ASIHTTPRequest *)request

{

// 當以文本形式讀取返回內容時用這個方法

NSString *responseString = [request responseString];

// 當以二進制形式讀取返回內容時用這個方法

NSData *responseData = [request responseData];

}

- (void)requestFailed:(ASIHTTPRequest *)request

{

NSError *error = [request error];

}

----------------------------------------------文章轉自http://www.cnblogs.com/dotey/archive/2011/05/10/2041966.html




發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章