HTTP キャッシュポリシー

UI から HTTP キャッシュポリシーを API に適用する場合は、次のパラメーターを設定できます。

キャッシュミスの場合、HTTP キャッシュポリシーは、送信された要求に対する応答がすでにキャッシュされているかどうかをチェックします。要求がバックエンドに到達したら、キャッシュミスの場合にのみプロセスが開始されます。次の図は、このシナリオで発生するイベントのフローを示しています。

キャッシュヒットの場合、HTTP キャッシュポリシーは、オブジェクトストアのキーを検索し、要求に対する応答が​保存済みエントリ​としてすでにキャッシュされていることを検出します。要求がバックエンドに向けてポリシーチェーンを進むことはなく、キャッシュされた応答が再利用されます。

キャッシュヒットの場合、キャッシュ後にポリシーチェーンで実行される必要のあるすべてのポリシーはそれ以降実行されません。

保存済みエントリ​は、キャッシュされた HTTP 応答です。キャッシュには、最大 1 MB のシリアル化可能データと入力ストリームを保存できます。値がこの制限を超えると、読み取りは停止し、値は保存されません。

キャッシュは辞書として機能し、そこではキャッシュに保存された各応答が​キー​と呼ばれる文字列に関連付けられます。たとえば、式 #[attributes.headers['key']] では、​key​ というヘッダーがエントリキーとして使用されます。

キャッシュには、指定された数のエントリを特定の期間保持できます。この数は、​Maximum Cache Entries​ プロパティを使用して設定できます。各保存済みエントリは、一定時間キャッシュメモリに保持されます。その後、エントリは期限切れになり、再度処理する必要があります。この有効期限は、​存続期間​ (TTL) と呼ばれます。

キャッシュが最大項目保存数に達したときもエントリの有効期限がトリガーされます。このシナリオが発生すると、FIFO (先入れ先出し) 条件を使用してエントリが削除されます。つまり、最も早くキャッシュに到達したエントリは、TTL 値にまだ達していなくても削除されます。

キャッシュの各エントリは、​Distributed​ オプション (表を参照) を使用して、クラスター内の各ノードや Runtime Manager の複数のワーカーで共有できます。このオプションが有効になっていない場合、各ノードには独自のキャッシュメモリが割り当てられます。

永続キャッシュでは、Mule Runtime Engine (Mule) または Flex レプリカが再起動しても、キャッシュの保存済みエントリを保持できます。

永続的なストアを使用するように設定された HTTP キャッシュポリシーを持つインスタンスのバージョンをアップグレードすると、ポリシーは以前のバージョンで保存されたエントリを維持しようとします。ただし、最悪のシナリオでは、キャッシュ内のエントリが無効になり、新しい要求の到着時にキャッシュが再入力されます。キャッシュ内のエントリのこの操作は自動的に実行され、ユーザーが意識することはありません。

Cache-Control​ ヘッダーは要求または応答に存在します。ヘッダーの使用可能な値は次のとおりです。これらの値は、カンマで区切って組み合わせることができます。

応答は検索されませんが、キャッシュに直接保存されます。

応答はキャッシュに保存されません。ただし、応答がキャッシュ内にすでに存在する場合は、ポリシーがその応答を返します。

どの値でも応答はキャッシュに保存されません。

<integer>​ プレースホルダーは、応答がキャッシュに残ることができる時間 (秒) を示す有効な整数に置き換える必要があります。両方のパラメーターが定義されている場合、​max-age​ よりも ​s-maxage​ が優先されます。

ポリシーでグローバル存続期間 (TTL) 値も定義されている場合、ヘッダーで指定されている時間がグローバル TTL よりも少ないと、これらのヘッダー値がポリシーで設定されているグローバル TTL よりも優先されます。

存在する場合、このヘッダーでキャッシュ内のエントリの有効期限を指定します。​max-age​ ディレクティブまたは ​s-maxage​ ディレクティブが指定されている場合、このヘッダーは無視されます。ヘッダー値は RFC-1123​ のとおりに定義する必要があります。

date​ ヘッダーが RFC-1123​ に従って定義されている場合、応答の作成日時が指定されます。定義されていない場合、​date​ ヘッダーが要求の受信時刻で追加されます。このヘッダーは、Cache-Control ヘッダーの ​max-age​ および ​s-maxage​ ディレクティブに定義された値と一緒に使用されます。

age​ ヘッダーは、date ヘッダーに指定されたキャッシュされている応答の作成以降の経過時間 (秒) を示します。このヘッダーはポリシーによって計算され、キャッシュから取得された各応答に追加されます。

有効期限は、​cache-control​、​date​、​expires​ ヘッダーを使用して計算されます。ただし、計算された有効期限がエントリの TTL 値で指定された存続時間を超える場合、キャッシュエントリの有効期限が切れます。

HTTP キャッシュポリシーで ​invalidate​ ヘッダーが設定されている場合、キャッシュ内のエントリが無効化され、要求が再度処理されます。[Invalidation Header (無効化ヘッダー)] 設定のヘッダーの名前を指定して、オプションを有効にします。ヘッダーの値には、​invalidate​ オプションのみを設定できます。

このオプションは、キーが現在の要求に一致するエントリを無効化します。 invalidate-all​ このオプションは、キャッシュからすべてのエントリを無効化します。

たとえば、ポリシーで要求の次の値が設定されているとします。

次のコマンドは、キャッシュからキーが "/my/policy" のエントリを無効化します。

curl http://<MyAppURL>/my/policy -H “myInvalidationHeader:invalidate”

次の要求は、キャッシュからすべてのエントリを無効化します。

curl http://<MyAppURL>/my/policy -H “myInvalidationHeader:invalidate-all”