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 中資訊的主要方法,用來決定何時使用快取資料、何時重新下載。每個 request 的 cache 策略可由其 cachePolicy 屬性控制,並以遮罩(bitmask)方式定義,因此可用位元「與」運算來組合。
// 每次都向伺服器詢問是否有新內容, // 若請求失敗則使用快取資料(即使已過期) [request setCachePolicy:ASIAskServerIfModifiedCachePolicy | ASIFallbackToCacheIfLoadFailsCachePolicy];
可用的 cache 策略選項:
當你設定了 cache 物件的 defaultCachePolicy 屬性,所有使用該 cache 的 request 都會套用此策略,除非你另外指定。
儲存策略讓你定義 cache 可保留特定回應資料多久。ASIHTTPRequest 目前支援兩種:
[ASIHTTPRequest clearSession] 時清除。ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url]; [request setCacheStoragePolicy:ASICachePermanentlyCacheStoragePolicy]; // 手動清除永久快取 [[ASIDownloadCache sharedCache] clearCachedResponsesForStoragePolicy:ASICachePermanentlyCacheStoragePolicy];
// 關閉 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]];
若你已有一個 download cache 並想接入 ASIHTTPRequest,或想自行撰寫 cache,只需讓你的 cache 實作 ASICacheDelegate 協定即可。