Targeted HTTP Cache Control

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

ターゲット化フィールドは Dictionary Structured Fields（Section 3.2 of [STRUCTURED-FIELDS]）です。Dictionary の各メンバーは HTTP キャッシュ応答指令（Section 5.2.2 of [HTTP-CACHING]）であり、拡張応答指令も含みます（Section 5.2.3 of [HTTP-CACHING]）。ターゲット化フィールドはしばしば Cache-Control フィールドと同じ構文を持ちますが、エラー処理の差異により Cache-Control パーサではなく Structured Fields パーサを使用することが相互運用性の問題を避けるために重要です。

キャッシュ指令は構造化データ型で定義されていないため、それらの値を適切な型にマッピングする必要があります。Section 5.2 of [HTTP-CACHING] は、キャッシュ指令の値が absent、quoted-string、または token のいずれかであることを定義しています。

これは、値がない指令は Boolean にマップされ（Section 3.3.6 of [STRUCTURED-FIELDS]）、quoted-string は String に、token はその内容に応じて Token、Integer、または Decimal にマップされることを意味します（それぞれ Section 3.3.3, Section 3.3.4, Section 3.3.1, Section 3.3.2 of [STRUCTURED-FIELDS] を参照）。

例えば、max-age 指令（Section 5.2.2.1）は整数値を持ちます。no-store（Section 5.2.2.5）は常に Boolean true であり、no-cache（Section 5.2.2.4）は Boolean true またはフィールド名のカンマ区切りリストを含む文字列のいずれかになり得ます。

実装はこれらの推定される制約に違反する値を生成してはなりません。特に、最初の文字が英字または "*" でない文字列値は、他の型と誤認されないように Strings として生成されなければなりません。

実装は、これらの推定制約に違反する値を消費すべきではありません。例えば、十進値を持つ max-age を整数に強制変換する消費実装は、他の実装と挙動が異なり、相互運用性の問題を引き起こす可能性があります。

キャッシュ指令に付与されたパラメータは、特別な取り扱いが明示されない限り無視されます。

ある応答におけるターゲット化フィールドが空である場合、または解析エラーが発生した場合、そのフィールドはキャッシュによって無視されなければなりません（つまり、そのフィールドが存在しないかのように振る舞い、他の cache-control メカニズムにフォールバックすることになります）。

この仕様を実装するキャッシュは target list（ターゲットリスト）を維持します。ターゲットリストはキャッシュポリシーに用いるターゲット化フィールド名の順序付きリストで、順序は最も適用されやすいものから最も適用されにくいものへの優先順を反映します。ターゲットリストは固定であったり、ユーザーが設定可能であったり、実装によってはリクエストごとに生成されたりします。

  [ExampleCDN-Cache-Control, CDN-Cache-Control]
  

この仕様を実装するキャッシュがターゲットリストにある1つ以上のヘッダーフィールド名を含む応答を受け取った場合、キャッシュはターゲットリスト順で最初に出現する有効かつ非空の値を持つフィールドを選択し、その値を応答のキャッシュポリシーを決定するために使用し、かつその応答内の Cache-Control および Expires ヘッダーフィールドを無視しなければなりません。ただし、リストにあるヘッダーフィールドから有効で非空の値が得られない場合は例外です。

これは応答ごとに発生する処理です。ターゲットリストのいずれのメンバーも存在せず、有効かつ非空でない場合、キャッシュは HTTP によって要求される他のキャッシュ制御メカニズムにフォールバックします（[HTTP-CACHING]参照）。

キャッシュのターゲットリストにないターゲット化フィールドは、そのキャッシュの挙動を変更してはならず、透過的に転送されなければなりません。

• max-age
• must-revalidate
• no-store
• no-cache
• private

さらに、Cache-Control 応答ヘッダーフィールドでサポートされるその他のキャッシュ指令（拡張指令を含む）についても、可能な限り実装することが推奨されます。

ターゲット化フィールド内のキャッシュ指令のセマンティクスと優先順位は Cache-Control 内のそれと同じです。特に、no-store と no-cache は max-age を無効にし、認識されない拡張指令は無視されます。

HTTP キャッシングには、Section 4.2 of [HTTP-CACHING] に定義された単一のエンドツーエンドの新鮮さモデルがあります。追加の新鮮さメカニズムがリクエスト経路の一部のキャッシュでのみ利用可能な場合（例えばターゲット化フィールドを使用する場合）、それらの相互作用は慎重に検討する必要があります。特に、ターゲット化されたキャッシュは他のキャッシュより長い新鮮さ有効期間を持つことがあり、他のキャッシュから見るとその応答が既に古く（場合によっては即座に古く）見えるため、キャッシュ効率に悪影響を及ぼすことがあります。

Age: 1800
Cache-Control: max-age=600
CDN-Cache-Control: max-age=3600

CDN の観点では、この応答はキャッシュ後30分でまだ新鮮ですが、他のキャッシュの観点ではこの応答は既に古くなっています。詳しくは [AGE-PENALTY] を参照してください。

• Age ヘッダーフィールドの除去
• Date ヘッダーフィールド値を現在時刻に更新
• Expires ヘッダーフィールド値を現在時刻に更新し、任意の Cache-Control: max-age 値を加算

本仕様はこれらの影響を緩和するための具体的要件を実装に課すものではありませんが、ターゲット化フィールドの定義はそれを行うことができます。

特定のキャッシュクラス向けのターゲットフィールドは、"Hypertext Transfer Protocol (HTTP) Field Name Registry"（<https://www.iana.org/assignments/http-fields/>）への登録を申請することで定義できます。

登録申請は本書を仕様文書として使うことができます。その場合、Comments フィールドはターゲットフィールドが適用されるキャッシュのクラスを明確に定義するべきです。あるいは、そのフィールドのための他の文書が作成されているなら、それを仕様文書として使用できます。

慣例として、ターゲット化フィールドは接尾辞 "-Cache-Control" を持ちます（例："ExampleCDN-Cache-Control"）。しかしこの接尾辞は慣例にすぎず、単独でターゲット化フィールドを識別するために用いてはなりません。

Cache-Control: max-age=60, s-maxage=120
CDN-Cache-Control: max-age=3600

CDN-Cache-Control: max-age=600
Cache-Control: no-store

Cache-Control: no-store

Cache-Control: no-store
CDN-Cache-Control: none

（注：'none' は登録されたキャッシュ指令ではありません；空の値を送信して無視されるのを避けるためにここでは用いています。）