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

ASIHTTPRequest 使用指南:上傳、下載與快取

編輯:iOS 開發綜合

ASIHTTPRequest 是一款功能完整的 iOS 網路庫。以下整理它幾項主要能力的用法。

上傳資料

使用 ASIFormDataRequest 模擬 Form 表單提交,其提交格式與 Header 會自動識別:沒有二進位檔時為 application/x-www-form-urlencoded,有二進位檔時則為 multipart/form-data。

ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:url];
[request setPostValue:@"Ben" forKey:@"first_name"];
[request setFile:@"/Users/ben/Desktop/ben.jpg" forKey:@"photo"];
[request addData:imageData withFileName:@"george.jpg" andContentType:@"image/jpeg" forKey:@"photos"];

若要發送自訂資料:

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request appendPostData:[@"This is my data" dataUsingEncoding:NSUTF8StringEncoding]];
[request setRequestMethod:@"PUT"];

下載檔案

透過 setDownloadDestinationPath 設定下載目標目錄。下載過程中,檔案會先存在暫存目錄;下載完成後,若資料是壓縮的會先解壓再放入目標目錄並刪除暫存檔,若下載失敗則把暫存檔移到目標目錄並取代同名檔。若要取得下載中的所有資料,可實作 delegate 的 request:didReceiveData:,但實作後需自行處理檔案存放。

取得回應與進度

[request responseStatusCode];
[[request responseHeaders] objectForKey:@"X-Powered-By"];
[request responseEncoding];

有兩個回呼可取得進度:downloadProgressDelegate(下載)與 uploadProgressDelegate(上傳)。

Cookie 支援

若存在 Cookie,會放在 NSHTTPCookieStorage 容器中共享並供下次使用。可用 [ASIHTTPRequest setSessionCookies:nil]; 清空所有 Cookie,也可停用預設 Cookie 政策、改用自訂 Cookie。

大檔案斷點續傳

0.94 之後支援大檔案斷點下載,只需設定:

[request setAllowResumeForFileDownloads:YES];
[request setDownloadDestinationPath:downloadPath];

它會自動保存存取過的 URL 資訊,在無網路連線、或已下載資料需確認是否更新時非常有用。

下載快取 (ASIDownloadCache)

它會對 GET 請求的成功回應進行快取:

[ASIHTTPRequest setDefaultCache:[ASIDownloadCache sharedCache]];

也可只讓某次請求使用快取,或建立多個 ASIDownloadCache 並存以指定不同路徑。快取政策是我們控制快取行為的主要方式,常見選項包括:

· ASIUseDefaultCachePolicy:預設政策。
· ASIDoNotReadFromCacheCachePolicy:讀取時不使用快取。
· ASIDoNotWriteToCacheCachePolicy:不寫入快取。
· ASIAskServerIfModifiedWhenStaleCachePolicy:預設行為,先判斷是否有快取、是否過期,必要時向伺服器確認版本。
· ASIOnlyLoadIfNotCachedCachePolicy:只要本地有快取,不論是否過期都直接使用。
· ASIFallbackToCacheIfLoadFailsCachePolicy:請求失敗時回退到本地快取,處理異常時非常好用。

快取存儲方式則有兩種:ASICacheForSessionDurationCacheStoragePolicy(預設,基於 session)與 ASICachePermanentlyCacheStoragePolicy(永久保存)。此外還可設定快取有效期、判斷資料是否來自快取(didUseCachedResponse),甚至透過實作 ASICacheDelegate 來自訂快取。

代理與其他特性

可手動設定 HTTP 代理(setProxyHost:、setProxyPort:)或使用 PAC 自動設定檔。此外還可設定:App 進入背景後仍繼續請求、是否在狀態列顯示網路活動指示器、逾時重試次數,以及 KeepAlive 的持久連線超時秒數等。這些細緻的設定讓 ASIHTTPRequest 成為當時 iOS 網路開發的強力工具。

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