ASIHTTPRequest可以自動緩存下載的數據。在很多情況下這很有用:
當你離線時,你無法再次下載數據,而你又需要訪問這些數據
從上次下載這些數據後,你只想在數據更新後才下載新的數據
你處理的數據永遠不會發生改變,所以你只想下載一次數據
在之前版本的ASIHTTPRequest裡,遇到上述情況,你只能自己處理這些策略。在一些情況下,使用download cache可以讓你不用再寫本地緩存機制。
ASIDownloadCache 是個簡單的URL cache,可以用來緩存GET請求的相應數據。一個request要被緩存,它首先必須請求成功(沒有發送錯誤),服務器必須返回200HTTP狀態值。或者,從1.8.1版本開始,301,302,303,307重定向狀態碼都可以。
要打開響應值的cache機制很簡單:
[ASIHTTPRequest setDefaultCache:[ASIDownloadCache sharedCache]];這樣做以後,所有的request都會自動使用cache。如果你願意,你可以讓不同的request使用共享的cache:
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setDownloadCache:[ASIDownloadCache sharedCache]];你不會被局限於使用單一的cache,你可以想創建多少cache就創建多少cache,只要你喜歡 ^ ^。當你自己創建一個cache,你必須設定cache的路徑——這路徑必須是一個你擁有寫權限的目錄。
ASIDownloadCache *cache = [[[ASIDownloadCache alloc] init] autorelease];
[cache setStoragePath:@"/Users/ben/Documents/Cached-Downloads"];
//別忘了 - 你必須自己retaining你自己的cache!
[self setMyCache:cache];
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setDownloadCache:[self myCache]];cache策略
cache策略是你控制cache中信息的主要方法,控制何時使用cache數據而非重新下載數據。
每個request的cache策略可是由request的cachePolicy 屬性來控制的。cache策略使用掩碼來定義,所以你可以二進制“與”操作他們。
// 每次都向服務器詢問是否有新的內容可用,
// 如果請求失敗, 使用cache的數據,即使這個數據已經過期了
[request setCachePolicy:ASIAskServerIfModifiedCachePolicy|ASIFallbackToCacheIfLoadFailsCachePolicy];你可以使用下列cache策略選項來控制request的緩存策略:
ASIUseDefaultCachePolicy 默認的cache 策略。請勿將這一項與其他項結合使用。當你設置一個request使用cache,它會使用cache的defaultCachePolicy. ASIDownloadCache的默認cache策略是‘ASIAskServerIfModifiedWhenStaleCachePolicy’.
ASIDoNotReadFromCacheCachePolicy 使用這一項,request將不會從cache中讀取數據
ASIDoNotWriteToCacheCachePolicy 使用這一項,request將不會把數據存入cache
ASIAskServerIfModifiedWhenStaleCachePolicy 這是ASIDownloadCaches的默認cache策略。使用這個策略時,request會先查看cache中是否有可用的緩存數據。如果沒有,request會像普通request那樣工作。
如果有緩存數據並且緩存數據沒有過期,那麼request會使用緩存的數據,而且不會向服務器通信。如果緩存數據過期了,request會先進行GET請求來想服務器詢問數據是否有新的版本。如果服務器說緩存的數據就是當前版本,那麼緩存數據將被使用,不會下載新數據。在這種情況下,cache的有效期將被設定為服務器端提供的新的有效期。如果服務器提供更新的內容,那麼新內容會被下載,並且新的數據以及它的有效期將被寫入cache。
ASIAskServerIfModifiedCachePolicy 這一項與ASIAskServerIfModifiedWhenStaleCachePolicy相同,除了一點:request將會每次都詢問服務器端數據是否有更新。
ASIOnlyLoadIfNotCachedCachePolicy 使用這一項,cache數據將一直被使用,無視過期時間
ASIDontLoadCachePolicy 使用這一項時,只有當響應數據有緩存時,request才會成功。如果一個request沒有緩存的響應數據,那麼這個request將會停止,並且不會有錯誤設置在request上。
ASIFallbackToCacheIfLoadFailsCachePolicy 當使用這一項時,當request失敗時,request會回頭請求cache數據。如果請求失敗後,request使用的cache數據,那麼這個request會成功(沒有錯誤)。你通常會將這一項與其他項結合使用,因為它適用於指定當發生錯誤時request的行為。
當你設定了一個cache對象的defaultCachePolicy 屬性,所有使用這個cache對象的request都會使用這個cache策略,除非你為request設置了另外的策略。
存儲策略
存儲策略允許你定義一個cache可以存儲特定的相應數據多久。ASIHTTPRequest目前支持兩種存儲策略:
ASICacheForSessionDurationCacheStoragePolicy是默認值。相應數據只會在會話期間被存儲,在第一次使用cache時,或者在調用 [ASIHTTPRequest clearSession]時,數據會被清除。
使用ASICachePermanentlyCacheStoragePolicy,緩存的相應數據會被永久存儲。要使用這個存儲策略,向request設置:
ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:url];
[request setCacheStoragePolicy:ASICachePermanentlyCacheStoragePolicy];要手動清除cache,調用函數clearCachedResponsesForStoragePolicy:,傳入要清除的cache數據的存儲策略:
[[ASIDownloadCache sharedCache] clearCachedResponsesForStoragePolicy:ASICachePermanentlyCacheStoragePolicy];其他cache相關的特性
// 當你關閉 shouldRespectCacheControlHeaders,cache對象會存儲響應數據,而無視
// 服務器的顯式“請勿緩存”聲明 (例如:cache-control 或者pragma: no-cache 頭)
[[ASIDownloadCache sharedCache] setShouldRespectCacheControlHeaders:NO];
// 可以設定request的secondsToCache來覆蓋服務器設定的內容有效期, 這時,響應數據
// 會一直被緩存,直到經過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中,或者你喜歡自己寫自己的download cache,那麼讓你的cache實現ASICacheDelegate協議。