HttpResponseCache 類別

定義

[Android.Runtime.Register("android/net/http/HttpResponseCache", DoNotGenerateAcw=true)]
public sealed class HttpResponseCache : Java.Net.ResponseCache, IDisposable, Java.IO.ICloseable

[<Android.Runtime.Register("android/net/http/HttpResponseCache", DoNotGenerateAcw=true)>]
type HttpResponseCache = class
    inherit ResponseCache
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

ResponseCache

HttpResponseCache

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ICloseable IDisposable

備註

快取 HTTP 和 HTTPS 回應到檔案系統，使其可重複使用，節省時間與頻寬。 此類別支援 java.net.HttpURLConnection 和javax.net.ssl.HttpsURLConnection;且 或 沒有平台提供的快取。DefaultHttpClientAndroidHttpClient 安裝和實例都是執行緒安全的。

<h3>安裝 HTTP 回應快取</h3> 透過在應用程式啟動時安裝快取，啟用應用程式所有 HTTP 請求的快取。 例如，這段程式碼會在檔案系統}的 安裝一個 10 MiB 快取 android.content.Context#getCacheDir() application-specific cache directory ：

{@code
              protected void onCreate(Bundle savedInstanceState) {
                  ...

                  try {
                      File httpCacheDir = new File(context.getCacheDir(), "http");
                      long httpCacheSize = 10 * 1024 * 1024; // 10 MiB
                      HttpResponseCache.install(httpCacheDir, httpCacheSize);
                  } catch (IOException e) {
                      Log.i(TAG, "HTTP response cache installation failed:" + e);
                  }
              }

              protected void onStop() {
                  ...

                  HttpResponseCache cache = HttpResponseCache.getInstalled();
                  if (cache != null) {
                      cache.flush();
                  }
              }}

此快取會根據需要逐出條目，以保持其大小不超過10 MiB。 最佳快取大小取決於應用程式，並取決於下載檔案的大小與頻率。 提高限制可能會提升命中率，但也可能浪費檔案系統空間！

對某些應用程式來說，將快取建立在外部儲存目錄中可能更為理想。 <強>外部儲存目錄沒有任何存取控制，因此不應用於可能包含私有資料的快取。</strong> 雖然通常有更多可用空間，但外部儲存是可選的，且—即使有 —使用過程中可能會消失。 使用 android.content.Context#getExternalCacheDir()。 如果此方法回傳 null，應用程式應該會退回到不快取或快取非外部儲存。 如果在使用過程中移除外部儲存裝置，快取命中率會降為零，且正在讀取快取的快取會失敗。

清除快取會強制其資料到檔案系統。 這確保所有寫入快取的回應在下一次活動開始時都能被讀取。

<h3>快取優化</h3> 為了衡量快取效能，此類別追蹤三個統計數據：<ul><li><強>#getRequestCount() Request Count:</強> 自建立此快取以來發出的 HTTP 請求數量。 <LI><強>#getNetworkCount() Network Count:</強> 需要使用網路的請求數量。 <LI><強/>#getHitCount() Hit Count:<強> 表示快取所回應的請求數量。 </ul> 有時請求會導致條件快取命中。 如果快取包含過時的回應副本，客戶端會發出條件式 GET。 伺服器接著會發送更新後的回應（如果有變更），若客戶端的副本仍然有效，則會發送簡短的「未修改」回應。 這類回應會增加網路數量和點擊數。

提升快取命中率的最佳方法是設定網頁伺服器回傳可快取的回應。 雖然此用戶端會尊重所有 HTTP/1.1（RFC 2068） 快取標頭，但不會快取部分回應。

<h3>強制網路回應</h3> 在某些情況下，例如使用者點擊「重新整理」按鈕後，可能需要跳過快取，直接從伺服器取得資料。 要強制完整刷新，請加入 no-cache 指令：

{@code
                    connection.addRequestProperty("Cache-Control", "no-cache");
            }

如果只需要強制伺服器驗證快取回應，則改用更有效率 max-age=0 的方法：

{@code
                    connection.addRequestProperty("Cache-Control", "max-age=0");
            }

<h3>強制快取回應</h3> 有時你會想顯示資源是否立即可用，但不然不會顯示。 這可以讓你的應用程式在等待最新資料下載時顯示 某些東西 。 若要限制請求至本地快取資源，請新增 only-if-cached 指令：

{@code
                try {
                    connection.addRequestProperty("Cache-Control", "only-if-cached");
                    InputStream cached = connection.getInputStream();
                    // the resource was cached! show it
                } catch (FileNotFoundException e) {
                    // the resource was not cached
                }
            }

這種技巧在回應陳腐總比沒有回應好的情況下效果更好。 為了允許過期快取回應，請使用 max-stale 最大分秒級的指令：

{@code
                    int maxStale = 60 * 60 * 24 * 28; // tolerate 4-weeks stale
                    connection.addRequestProperty("Cache-Control", "max-stale=" + maxStale);
            }

<h3>與早期版本<相容/h3> 此類別於 Android 4.0（冰淇淋三明治）中新增。 使用反射來啟用回應快取，同時不影響早期版本：

{@code
                  try {
                      File httpCacheDir = new File(context.getCacheDir(), "http");
                      long httpCacheSize = 10 * 1024 * 1024; // 10 MiB
                      Class.forName("android.net.http.HttpResponseCache")
                              .getMethod("install", File.class, long.class)
                              .invoke(null, httpCacheDir, httpCacheSize);
                  } catch (Exception httpResponseCacheNotAvailable) {
                  }}

Java 文件 android.net.http.HttpResponseCache。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。