Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the ETag (section 14.20 14.19), If-Match (section 14.25 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. The definition of how they are used and compared as cache validators is in section 13.3.3. An entity tag consists of an opaque quoted string, possibly prefixed by a weakness indicator.

実体札は、要求された同じ資源からの2つ以上の実体群を比較するのに使います。 HTTP/1.1 は実体札を ETag, If-Match, If-None-Match, If-Range 各頭欄で使います。 これらの頭欄をキャッシュ検証子としてどう使用・比較するかの定義は13.3.3節にあります。 一つの実体札は、一つの不透明な引用文字列で構成されます。 頭に弱性指示子がつくこともあります。

• entity-tag = [ weak ] opaque-tag
• weak = "W/"
• opaque-tag = quoted-string

A "strong entity tag" may MAY be shared by two entities of a resource only if they are equivalent by octet equality.

「強い実体札」は、一つの資源の二つの実体がオクテット比較で同等である場合に限って両実体で共有しても構いません。

A "weak entity tag," indicated by the "W/" prefix, may MAY be shared by two entities of a resource only if the entities are equivalent and could be substituted for each other with no significant change in semantics. A weak entity tag can only be used for weak comparison.

「弱い実体札」は、 W/ という接頭辞で示します。 一つの資源の二つの実体が同等であり、意味上重大な変更を加えてしまうことなしに互いに代替することができるのであれば、 両実体で共有しても構いません。弱い実体札は弱い比較の時だけ使うことができます。

An entity tag MUST be unique across all versions of all entities associated with a particular resource. A given entity tag value may MAY be used for entities obtained by requests on different URIs without implying anything about the equivalence of those entities. The use of the same entity tag value in conjunction with entities obtained by requests on different URIs does not imply the equivalence of those entities.

実体札は、特定の資源に関連付けられているすべての実体のすべての版に渡って固有なものでなければなりません。 ある実体札値は、それらの実体の同等性について何ら暗示することなしに、 異なる URI についての要求群で得られる実体群について使用しても構いません。異なる URI についての要求群で得られる実体に同じ実体札値が使われていても、それらの実体が同等であることを暗示するわけではありません。

ETagの文字列はmod_perlのset_etagメソッド内部で呼び出される Apacheのap_make_etag()関数で生成されています。この関数はファ イルに対するリクエストの場合

• ファイルのinode番号
• ファイルのファイルサイズ
• ファイルの更新時刻

の情報を"-"で連結した文字列を生成し、ファイルに対するリクエ ストではない場合は

• ap_set_last_modified()などでセットした更新時刻

の文字列を生成します。

なのでファイルへのアクセスを処理するコンテンツハンドラであ れば、「他のスタティックなコンテンツ」と同じ形式のETagが生 成されますが、ファイルの実体を持たないコンテンツハンドラの 場合は最終更新日だけをつかったETagが生成されます。 と、これはset_etagメソッドでETagを設定する場合で、 set_etagメソッドを使わずに自分でETagを生成・セットすること もできます。

  % perl -e 'printf q{"%x-%x-%x"}, (stat("/docs/charset.html"))[1,7,9]'
>
;; 詳しくは$APACHE_SRC/main/http_protocol.cのap_set_etag()と
ap_make_etag()を見てください。