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をサポートします。 DefaultHttpClient または AndroidHttpClient用にプラットフォームによって提供されるキャッシュはありません。 インストールとインスタンスはスレッド セーフです。

<h3> HTTP 応答キャッシュのインストール</h3> アプリケーションの起動時にキャッシュをインストールして、アプリケーションのすべての HTTP 要求のキャッシュを有効にします。 たとえば、次のコードは、ファイルシステムの android.content.Context#getCacheDir() application-specific cache directory に 10 MiB キャッシュをインストールします}。

{@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>外部ストレージ ディレクトリにはアクセス制御がないため、プライベート データを含むことができるキャッシュには使用しないでください</strong> 多くの場合、空き領域が増えますが、外部ストレージは省略可能であり、#8212 です。使用可能な場合でも>#8212;は使用中に消える可能性があります。 android.content.Context#getExternalCacheDir()を使用して外部キャッシュ ディレクトリを取得します。 このメソッドが null を返す場合、アプリケーションは、外部以外のストレージでキャッシュまたはキャッシュしないようにフォールバックする必要があります。 使用中に外部ストレージが削除されると、キャッシュヒット率はゼロに低下し、進行中のキャッシュ読み取りは失敗します。

キャッシュをフラッシュすると、そのデータが強制的にファイル システムに送信されます。 これにより、キャッシュに書き込まれたすべての応答が、次回アクティビティが開始された時点で読み取り可能になります。

<h3>Cache Optimization</h3> このクラスは、キャッシュの有効性を測定するために、 <ul><li><strong>#getRequestCount() Request Count:</strong> このキャッシュが作成されてから発行された HTTP 要求の数という 3 つの統計情報を追跡します。 <li><strong>#getNetworkCount() Network Count:</strong> ネットワーク使用が必要な要求の数。 <li><strong>#getHitCount() Hit Count:</strong> キャッシュによって応答が処理された要求の数。 </ul> 要求によって条件付きキャッシュ ヒットが発生することがあります。 キャッシュに応答の古いコピーが含まれている場合、クライアントは条件付き GETを発行します。 サーバーは、変更された場合は更新された応答を送信し、クライアントのコピーがまだ有効な場合は短い "変更されていません" 応答を送信します。 このような応答は、ネットワークカウントとヒットカウントの両方をインクリメントします。

キャッシュ ヒット 率を向上させる最善の方法は、キャッシュ可能な応答を返すように Web サーバーを構成することです。 このクライアントは 、すべての 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ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。