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

ASIHTTPRequest:使用 Download Cache 下載快取

編輯:iOS 開發綜合

為何使用 Download Cache

ASIHTTPRequest 可以自動快取下載的資料,在許多情況下相當實用:

  • 當你離線、無法再次下載資料,卻又需要存取這些資料時;
  • 當你只想在資料更新後才下載新資料時;
  • 當你處理的資料永不改變、只想下載一次時。

在早期版本的 ASIHTTPRequest 中,遇到上述情況只能自行處理這些策略。而在部分情境下,使用 download cache 可以讓你省下撰寫本地快取機制的工夫。

基本用法

ASIDownloadCache 是一個簡單的 URL cache,用來快取 GET 請求的對應資料。一個 request 要被快取,首先必須請求成功(沒有發生錯誤),且伺服器須回傳 200 HTTP 狀態值(自 1.8.1 版起,301、302、303、307 等重定向狀態碼亦可)。

要啟用回應的快取機制很簡單:

[ASIHTTPRequest setDefaultCache:[ASIDownloadCache sharedCache]];

如此一來,所有 request 都會自動使用快取。你也可以讓不同的 request 使用共享的 cache:

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setDownloadCache:[ASIDownloadCache sharedCache]];

你不必侷限於單一 cache,可以依需求建立多個。自行建立 cache 時,必須設定其路徑——該路徑必須是一個你擁有寫入權限的目錄:

ASIDownloadCache *cache = [[[ASIDownloadCache alloc] init] autorelease];
[cache setStoragePath:@"/Users/ben/Documents/Cached-Downloads"];

// 別忘了:你必須自行 retain 自己的 cache!
[self setMyCache:cache];

ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setDownloadCache:[self myCache]];

Cache 策略

cache 策略是控制 cache 中資訊的主要方法,用來決定何時使用快取資料、何時重新下載。每個 request 的 cache 策略可由其 cachePolicy 屬性控制,並以遮罩(bitmask)方式定義,因此可用位元「與」運算來組合。

// 每次都向伺服器詢問是否有新內容,
// 若請求失敗則使用快取資料(即使已過期)
[request setCachePolicy:ASIAskServerIfModifiedCachePolicy | ASIFallbackToCacheIfLoadFailsCachePolicy];

可用的 cache 策略選項:

  • ASIUseDefaultCachePolicy:預設策略,請勿與其他選項組合。ASIDownloadCache 的預設策略是 ASIAskServerIfModifiedWhenStaleCachePolicy。
  • ASIDoNotReadFromCacheCachePolicy:request 不會從 cache 讀取資料。
  • ASIDoNotWriteToCacheCachePolicy:request 不會把資料存入 cache。
  • ASIAskServerIfModifiedWhenStaleCachePolicy:ASIDownloadCache 的預設策略。先查看 cache 是否有可用資料:若無則如常運作;若有且未過期,直接使用快取而不與伺服器通訊;若已過期,則先發 GET 請求詢問伺服器,伺服器若答覆快取仍為最新則沿用並更新有效期,若有更新內容則下載並寫入 cache。
  • ASIAskServerIfModifiedCachePolicy:與上一項相同,但每次都會詢問伺服器是否有更新。
  • ASIOnlyLoadIfNotCachedCachePolicy:無視過期時間,一律使用快取資料。
  • ASIDontLoadCachePolicy:只有在有快取時 request 才會成功;若無快取則停止,且不會設定錯誤。
  • ASIFallbackToCacheIfLoadFailsCachePolicy:request 失敗時回頭使用快取資料,此時 request 會視為成功(無錯誤)。通常會與其他選項組合使用。

當你設定了 cache 物件的 defaultCachePolicy 屬性,所有使用該 cache 的 request 都會套用此策略,除非你另外指定。

儲存策略

儲存策略讓你定義 cache 可保留特定回應資料多久。ASIHTTPRequest 目前支援兩種:

  • ASICacheForSessionDurationCacheStoragePolicy(預設):回應資料只在工作階段期間保留,首次使用 cache 時或呼叫 [ASIHTTPRequest clearSession] 時清除。
  • ASICachePermanentlyCacheStoragePolicy:永久保留快取的回應資料。
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setCacheStoragePolicy:ASICachePermanentlyCacheStoragePolicy];

// 手動清除永久快取
[[ASIDownloadCache sharedCache] clearCachedResponsesForStoragePolicy:ASICachePermanentlyCacheStoragePolicy];

其他 cache 相關特性

// 關閉 shouldRespectCacheControlHeaders 後,cache 會無視伺服器的
// 「請勿快取」聲明(如 cache-control 或 pragma: no-cache)仍照存回應資料
[[ASIDownloadCache sharedCache] setShouldRespectCacheControlHeaders:NO];

// 以 secondsToCache 覆寫伺服器設定的有效期
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setSecondsToCache:60*60*24*30]; // 快取 30 天

// request 開始執行後,若回應資料取自快取,didUseCachedResponse 會回傳 YES
[request didUseCachedResponse];

// 向 cache 索取一個路徑來儲存回應資料,這是使用 download cache 最有效率的方法,
// 因為 request 完成後資料無需再複製到 cache
[request setDownloadDestinationPath:
    [[ASIDownloadCache sharedCache] pathToStoreCachedResponseDataForRequest:request]];

自訂 cache

若你已有一個 download cache 並想接入 ASIHTTPRequest,或想自行撰寫 cache,只需讓你的 cache 實作 ASICacheDelegate 協定即可。

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