您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

詳解 iOS 中的 ASIHTTPRequest 網路請求

編輯:iOS 開發綜合

前言

使用 iOS SDK 中的 HTTP 網路請求 API 相當複雜,調用也頗為繁瑣。ASIHTTPRequest 對 CFNetwork API 進行了封裝,使用起來非常簡單,外號「HTTP 終結者」,以 Objective-C 編寫,運行效率很高,可良好地應用於 Mac OS X 與 iOS 平台的應用程式中,適用於基本的 HTTP 請求以及與基於 REST 的服務之間的交互。可惜作者早已停止更新,一些潛在的 BUG 無人解決,很多公司的舊項目裡都殘留著它的身影——以前的不少 iOS 項目都是 ASI + SBJson,會不會用 ASI 幾乎可算是檢驗老牌 iOS 程式員的標準之一。從 iOS 9 開始,CFNetwork 相關的類與方法逐漸被廢棄,可以用 AFNetworking 來替換 ASIHTTPRequest。此外,在 iOS 9+ 中使用 ASIHTTPRequest 無需對 App Transport Security Settings 添加設置。

1、ASIHTTPRequest

1.1 ASI 主要特色

  • 透過簡單的接口,即可完成向伺服器提交資料與從伺服器獲取資料的工作。
  • 下載的資料可儲存到記憶體中,或直接儲存到磁碟中。
  • 能上傳本地檔案到伺服器。
  • 可方便地存取與操作請求和返回的 HTTP 標頭資訊。
  • 可獲取上傳或下載的進度資訊,為應用程式提供更好的體驗。
  • 支援上傳或下載隊列,並可獲取隊列的進度資訊。
  • 支援基本、摘要與 NTLM 身份認證,在同一會話中授權憑證會自動維持,並可儲存在 Keychain(Mac 與 iOS 作業系統的密碼管理系統)中。
  • 支援 Cookie。
  • 當應用(iOS 4+)在後台運行時,請求可以繼續運行。
  • 支援 GZIP 壓縮資料。
  • 內建的 ASIDownloadCache 類可緩存請求返回的資料,即使沒有網路也能返回已緩存的結果。
  • ASIWebPageRequest 可下載完整網頁(含內嵌網頁、樣式表、腳本等資源檔案)並顯示在 UIWebView /WebView 中,任意大小的頁面都可無限期緩存,即使離線也能瀏覽。
  • 支援客戶端憑證。
  • 支援透過代理發起 HTTP 請求。
  • 支援帶寬限制:在 iOS 平台可依當前網路情況自動決定是否限制帶寬,例如使用 WWAN(GPRS/Edge/3G)時限制,而使用 WiFi 時不做限制。
  • 支援斷點續傳。
  • 支援同步與異步請求。

1.2 AFN 與 ASI 的區別

1、底層實現

1)AFN 的底層基於 OC 的 NSURLConnection 與 NSURLSession;

2)ASI 的底層基於純 C 語言的 CFNetwork 框架;

3)由於 NSURLConnection 與 NSURLSession 是在 CFNetwork 之上的一層封裝,因此 ASI 的運行性能要高於 AFN。

2、對伺服器返回資料的處理

1)ASI 沒有直接提供對伺服器資料處理的方式,直接返回的是 NSData/NSString;

2)AFN 提供了多種對伺服器資料處理的方式:(1) JSON 處理,直接返回 NSDictionary 或 NSArray;(2) XML 處理,返回 XML 類型資料,需自行解析;(3) 其他類型資料處理。

3、監聽請求過程

1)AFN 提供了 success 與 failure 兩個 block 來監聽請求過程(只能監聽成功與失敗):success 在請求成功後調用,failure 在請求失敗後調用。

2)ASI 提供了三套方案,每一套都能監聽請求的完整過程(請求開始、接收到響應標頭、接收到具體資料、接收完畢、請求失敗):成為代理並遵守協議、實現協議中的代理方法;成為代理但不遵守協議、自定義代理方法;設定 block。

4、在檔案下載與上傳的使用難易度

1)AFN:不易實現監聽下載與上傳進度,不易實現斷點續傳,一般只用來下載不大的檔案。

2)ASI:非常容易實現下載與上傳,非常容易監聽進度,非常容易實現斷點續傳,下載大檔案或小檔案均可。因此實現下載上傳推薦使用 ASI。

5、網路監控

1)AFN 自己封裝了網路監控類,易於使用;

2)ASI 使用的是 Reachability,因為用 CocoaPods 下載 ASI 時會同步下載 Reachability,但 Reachability 作為網路監控使用較為複雜(相對於 AFN 的網路監控類而言);

3)推薦使用 AFN 做網路監控 AFNetworkReachabilityManager。

6、ASI 提供的其他實用功能

1)控制信號旁邊的圈圈是否要在請求過程中轉動;

2)可輕鬆設置請求之間的依賴:每個請求都是一個 NSOperation 物件;

3)可統一管理所有請求(還專門提供了一個 ASINetworkQueue 來管理所有請求物件),可暫停/恢復/取消所有請求,並監聽整個隊列中所有請求的下載與上傳進度。

2、ASIHTTPRequest 的使用

2.1 添加 ASIHTTPRequest

Github 網址:https://github.com/pokeb/asi-http-request

https://allseeing-i.com/ASIHTTPRequest/

ASIHTTPRequest 系統需求:

1.8.1 -> 1.8.2 對應 Minimum iOS Target 3.0+;0.2 -> 1.8.0 為其他版本。

ASIHTTPRequest 使用 MRC。

 // 添加系統庫文件 CFNetwork.framework SystemConfiguration.framework MobileCoreServices.framework CoreGraphics.framework libz.1.1.3.tbd libxml2.2.tbd // 添加第三方庫文件 ASIHTTPRequest-1.8.2 // 在 TARGETS -> Builed Settings -> Search Paths -> Header Search Paths 中添加文件路徑 /usr/include/libxml2 // 在 TARGETS -> Build Phases -> Compile Sources -> ...in .../ASIHTTPRequest 後添加 -fno-objc-arc // 包含頭文件 #import "ASIHTTPRequest.h" #import "ASIFormDataRequest.h" 

2.2 ASIHTTPRequest 的設置

 // 設置請求頭 ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:[NSURL URLWithString:@"https://api.hudong.com/iphonexml.do?type=focus-c"]]; [request addRequestHeader:@"Referer" value:@"https://www.dreamingwish.com/"]; // 設置應用後台運行時是否仍然請求數據 request.shouldContinueWhenAppEntersBackground = YES; // 設置請求超時時重試的次數 request.numberOfTimesToRetryOnTimeout = 3; // 設置 KeepAlive 支持 // Set the amount of time to hang on to a persistent connection before it should expire to 2 minutes request.persistentConnectionTimeoutSeconds = 120; // Disable persistent connections entirely request.shouldAttemptPersistentConnection = NO; // 設置是否顯示網絡請求信息在 status bar 上 [ASIHTTPRequest setShouldUpdateNetworkActivityIndicator:NO]; // 網絡狀態檢查 BOOL isNetworkInUse = [ASIHTTPRequest isNetworkInUse]; 

3、ASI 同步 GET 請求

這是 ASIHTTPRequest 最簡單的一種使用模式:發送 startSynchronous 訊息後,即開始在同一執行緒中執行 HTTP 請求,執行緒會一直等待直到請求結束(成功或失敗)。透過檢查 error 屬性可判斷請求是否成功或有錯誤發生。要獲取返回的文字資訊,調用 responseString 方法;若下載的是二進位檔案(如圖片、MP3),則調用 responseData 方法,可得到一個 NSData 物件。

一般情況下,應優先使用異步請求代替同步請求,因為在主執行緒中使用同步請求會阻塞主執行緒的執行,導致使用者介面無法響應操作、任何動畫都停止渲染,直到請求完成。

資料請求

 NSURL *url = [NSURL URLWithString:@"https://api.hudong.com/iphonexml.do?type=focus-c"]; // 創建請求 ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; // 設置超時時間,可不設置,使用默認 request.timeOutSeconds = 5; // 發送同步請求 [request startSynchronous]; // 獲得錯誤信息 NSError *error = [request error]; // 網絡請求失敗 if (error) { // 網絡請求成功 NSLog(@"網絡請求失敗:\n%@", error); } else { // 獲得服務器的響應,字符串格式 NSString *responseString = [request responseString]; NSLog(@"網絡請求成功:\n%@", responseString); // 獲得服務器的響應,NSData 格式 NSData *responseData = [request responseData]; textView.text = [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding]; } 

檔案下載

透過設定 request 的 setDownloadDestinationPath,可設置下載檔案的目標目錄。下載過程中檔案會先保存在 temporaryFileDownloadPath 目錄下,若下載完成會做以下事情:

1,若資料是壓縮的,進行解壓,並把檔案放到 downloadDestinationPath 目錄中,臨時檔案被刪除;

2,若下載失敗,臨時檔案被直接移到 downloadDestinationPath 目錄,並替換同名檔案。

如果想獲取下載中的所有資料,可實現 delegate 中的 request:didReceiveData: 方法。但一旦實現了這個方法,request 在下載完後便不會把檔案放到 downloadDestinationPath 中,需要手動處理。

 NSURL *url = [NSURL URLWithString:@"https://www.dreamingwish.com/wp-content/uploads/2011/10/asihttprequest-auth.png"]; ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; // 設置文件存儲路徑 [request setDownloadDestinationPath:@"/Users/JHQ0228/Desktop/asi.png"]; [request startSynchronous]; // 獲得錯誤信息 NSError *error = [request error]; // 網絡請求失敗 if (error) { NSLog(@"網絡請求失敗:\n%@", error); } else { // 網絡請求成功 NSLog(@"網絡請求成功:\n"); } 

4、ASI 異步 GET 請求

請求在後台執行緒中運行,執行完後再通知調用的執行緒,這樣就不會導致主執行緒進行網路請求時介面被鎖定等情況。

1、協議方式

這裡實現了兩個 delegate 方法:資料請求成功時調用 requestFinished,請求失敗時(如網路問題或伺服器內部錯誤)調用 requestFailed。

 NSURL *url = [NSURL URLWithString:@"https://api.hudong.com/iphonexml.do?type=focus-c"]; // 創建請求 ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; // 設置超時時間,可不設置,使用默認 request.timeOutSeconds = 5; // 設置代理,需遵守 <ASIHTTPRequestDelegate> 協議 request.delegate = self; // 發送異步請求 [request startAsynchronous]; // 網絡請求成功,協議方法 - (void)requestFinished:(ASIHTTPRequest *)request { } // 網絡請求失敗,協議方法 - (void)requestFailed:(ASIHTTPRequest *)request { } 

2、Block 方式

在平台支援情況下,ASIHTTPRequest 1.8 以上支援 block。

 NSURL *url = [NSURL URLWithString:@"https://api.hudong.com/iphonexml.do?type=focus-c"]; // 創建請求,加 __weak 除去 block 循環調用警告 __weak ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; // 設置超時時間,可不設置,使用默認 request.timeOutSeconds = 5; // 發送異步請求 [request startAsynchronous]; // 網絡請求成功 [request setCompletionBlock:^{ }]; // 網絡請求失敗 [request setFailedBlock:^{ }]; 

5、ASI POST 請求

1、POST 表單

ASIFormDataRequest 用來模擬 Form 表單提交,其提交格式與 Header 會自動識別。檔案中的資料是按需從磁碟加載的,因此只要 Web 伺服器能處理,上傳大檔案沒有問題。

 // 通常數據是以 'application/x-www-form-urlencoded' 格式發送的,如果上傳了二進制數據或者文件,那麼格式將自動變為 'multipart/form-data'。 ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"https://www.dreamingwish.com"]]; // 沒有文件 [request setPostValue:@"Ben" forKey:@"first_name"]; [request setPostValue:@"Copsey" forKey:@"last_name"]; // 發送文件 [request setFile:@"/Users/ben/Desktop/ben.jpg" forKey:@"photo"]; // 數據的 mime 頭是自動判定的,但是如果你想自定義mime頭,那麼這樣: ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"https://www.dreamingwish.com"]]; // Upload a file on disk [request setFile:@"/Users/ben/Desktop/ben.jpg" withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"]; // Upload an NSData instance NSData *imageData = UIImagePNGRepresentation([UIImage imageNamed:@"myphoto.jpg"]); [request setData:imageData withFileName:@"myphoto.jpg" andContentType:@"image/jpeg" forKey:@"photo"]; // 你可以使用 addPostValue 方法來發送相同 name 的多個數據: ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:[NSURL URLWithString:@"https://www.dreamingwish.com"]]; [request addPostValue:@"Ben" forKey:@"names"]; [request addPostValue:@"George" forKey:@"names"]; 

2、PUT 請求、自定義 POST 請求

若想發送 PUT 請求,或想自定義 POST 請求,可使用 appendPostData: 或 appendPostDataFromFile:。

 ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:[NSURL URLWithString:@"https://www.dreamingwish.com"]]; [request appendPostData:[@"This is my data" dataUsingEncoding:NSUTF8StringEncoding]]; // Default becomes POST when you use appendPostData: / appendPostDataFromFile: / setPostBody: [request setRequestMethod:@"PUT"]; 

以上就是本文的全部內容,希望對大家的學習有所幫助。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved