[14] Want-Digest: ヘッダーは、 クライアントが希望するダイジェストアルゴリズムを指定するものです。

仕様書

意味

[3] Want-Digest: ヘッダーは、 送信者が要求URLに関連付けられたメッセージの実現値ダイジェストを受信することを望んでいると示すものです >>2。

[15] Content-MD5: ヘッダーの受信を望んでいるかどうかを示す値 contentMD5 も定義されています。

構文

[4] このヘッダーの値は、0個以上の値のリスト (#) です >>2。

  1. ?
    1. 値
    2. *
      1. OWS
      2. ,
      3. OWS
      4. 値

[5] それぞれの値は、ダイジェストアルゴリズムの名前と、 省略可能な q 引数です >>2。

[6] 仕様書の時代的に構文上明記されていませんが、 ; の前後には空白が挿入できると思われます。

  1. ダイジェストアルゴリズム
  2. ?
    1. OWS
    2. ;
    3. OWS
    4. q
    5. =
    6. q値

q 引数

[10] ダイジェストアルゴリズムには q 引数を指定できます。 指定しない場合、q値 1.0 とみなします >>2。

[7] q 引数の名前は大文字・小文字不区別です >>2。

[13] 複数のダイジェストアルゴリズムが指定された場合は、 q値が最高のもの(たち)が送信者がより好んでいるpreferredダイジェストアルゴリズムとなります。 >>2

[11] 送信者が受信することを望んでいるのは、 Want-Digest: ヘッダーで明示され、 q値が 0 でないダイジェストアルゴリズムのみです >>2。

[12] このヘッダーが指定されなければ、どのダイジェストアルゴリズムも望んでいないことになります。[16] Want-Digest: で指定されなかったり、 q値として 0 が指定されたりしても、 Digest: や Content-MD5: の生成が禁止されているわけでは無いようです。 (Digest: 参照。)

文脈

[18] Metalink/HTTP クライアントは、実現値ダイジェストを要求しなければなりません >>17。

歴史

[1] RFC 3230 (実現値要約) 4.3.1 Want-Digest

The Want-Digest message header field indicates the sender's desire to receive an instance digest on messages associated with the Request-URI.

Want-Digest メッセージ頭欄は、 Request-URI に関連付けられたメッセージに関する実現値を受信するとの送信者の希望を示します。

  • Want-Digest = "Want-Digest" ":" #(digest-algorithm [ ";" "q" "=" qvalue])

If a digest-algorithm is not accompanied by a qvalue, it is treated as if its associated qvalue were 1.0.

digest-algorithm に qvalue が添えられていなければ、関連付けられた qvalue は 1.0 であるものとして扱います。

The sender is willing to accept a digest-algorithm if and only if it is listed in a Want-Digest header field of a message, and its qvalue is non-zero.

メッセージの Want-Digest 頭欄に digest-algorithm が列せられていて、その qvalue が非零であるとき、この場合に限って送信者はその digest-algorithm を受け入れる意志があります。

If multiple acceptable digest-algorithm values are given, the sender's preferred digest-algorithm is the one (or ones) with the highest qvalue.

複数の受け入れ可能な digest-algorithm 値が与えられた時は、 送信者の好む digest-algorithm は最高の qvalue をもつ物(達)です。

Examples:

  • Want-Digest: md5
  • Want-Digest: MD5;q=0.3, sha;q=1

[9] RFC 4229 はIANA登録簿に状態「標準」で登録しています >>8。