Edit

Page

Page title:

Page body:

[30] [DFN[[CODE(HTTP)@en[[[Warning:]]]]]] [[ヘッダー]]は、
[[キャッシュ]]その他による配送中の[[メッセージ]]の処理に関する警告を表します。

* 仕様書

[REFS[
- [3] '''[CITE@en[RFC 7234 - Hypertext Transfer Protocol (HTTP/1.1): Caching]] ([TIME[2014-09-11 10:19:59 +09:00]] 版) <https://tools.ietf.org/html/rfc7234#section-5.5>'''
- [67] [CITE@en[RFC 7234 - Hypertext Transfer Protocol (HTTP/1.1): Caching]] ([TIME[2014-09-11 10:19:59 +09:00]] 版) <https://tools.ietf.org/html/rfc7234#section-7.2>
- [66] [CITE[Hypertext Transfer Protocol (HTTP) Warn Codes]] ([TIME[2014-06-11 21:56:03 +09:00]] 版) <http://www.iana.org/assignments/http-warn-codes/http-warn-codes.xhtml>
- [47] [CITE[Session Initiation Protocol (SIP) Parameters]] ([TIME[2014-09-24 16:02:34 +09:00]] 版) <http://www.iana.org/assignments/sip-parameters/sip-parameters.xhtml#sip-parameters-5>
-- [21] [DEL[<http://www.iana.org/assignments/sip-parameters>]]
]REFS]

* 意味

[5] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]は[[状態符号]]に反映されないかもしれない[[メッセージ]]の状態や[[変形]]についての追加情報を伝えるものです
[SRC[>>3]]。

[7] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]の警告の意味は、
[[警告符号]]によって表されます。警告には[[キャッシュ]]に関連するものもあれば、
そうでないものもあります [SRC[>>3]]。

[8] [[HTTP]] [[応答メッセージ]]では[[状態符号]]によって[[誤り]]を表すこともできますが、
[[警告符号]]は真の失敗ではなく、[[状態符号]]とは独立した付加情報としての警告を表しています。

[6] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]はどの[[HTTPメッセージ]]でも使うことができます。
ただし一部の[[警告符号]]は[[キャッシュ]]専用で、[[応答メッセージ]]にしか適用されません。
[SRC[>>3]]

* 構文

[9] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]の値は、
1つ以上の警告値の[[リスト]] ([CODE(HTTP)[#]]) です [SRC[>>3]]。

[FIG(railroad)[
= 警告値
= *
== [[OWS]]
== [CODE(HTTP)[[[,]]]]
== [[OWS]]
== 警告値
]FIG]

[15] 警告値は、[[警告符号]]、[[警告エージェント]]、警告テキスト、警告日時を
[CODE(char)[[[SP]]]] で区切って並べたものです。ただし警告日時とその直前の
[CODE(char)[[[SP]]]] は省略できます。 [SRC[>>3]]

[FIG(railroad)[
= [[警告符号]]
= [CODE(char)[[[SP]]]]
= [[警告エージェント]]
= [CODE(char)[[[SP]]]]
= 警告テキスト
= ?
== [CODE(char)[[[SP]]]]
== 警告日時
]FIG]

;; [16] [[HTTPにおける空白]]も参照。

* 文脈

[40] この[[ヘッダー]]は、複数指定できます [SRC[>>3]]。

[42] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]を[[生成]]する[[送信者]]は[[利用者エージェント]]の表示順 (>>41)
を念頭に置いて [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]の順序を決めることを[RUBYB[推奨]@en[encourage]]します。
新しい [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]を[[生成]]する場合は既存の
[CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]の後に追加しなければ[['''なりません''']]。
[SRC[>>3]]

;; [43] 同時に複数の警告を[[生成]]するときの順序は表示順をもとに決めるべきであるものの、
既存の警告に割り込んではいけないということのようです。

* 警告符号

[17] [DFN[[[警告符号]]]] ([DFN[[CODE(ABNF)@en[[[warn-code]]]]]]) は、
3桁の[[ASCII数字]]です [SRC[>>3]]。

[FIG(railroad)[
= [[ASCII数字]]
= [[ASCII数字]]
= [[ASCII数字]]
]FIG]

;; [33] [[RFC 2068]] では2桁数字でしたが、 [[RFC 2616]] で3桁に改められました。

;; [34] 同じく3桁数字である[[状態符号]]とは、まったく関係がありません。
同じ値が使われることがありますが、意味はまったく異なります。

[45] [[HTTP]] は100番台と200番台を使っています。
[FIG(list)[
- [49] [CODE(HTTP)[[[1xx]]]] は[[新鮮度]]や[[検証]]についての状態を表します [SRC[>>3]]。
- [50] [CODE(HTTP)[[[2xx]]]] は[[検証]]に左右されない[[表現]]の性質を表します [SRC[>>3]]。
]FIG]

[46] [[SIP]] は300番台を使っており、意味により次のように割り当てられています。
[FIG(list)[
- [22] [[300]]〜[[329]] は、[[セッション記述]]中の[[見出し語]]に問題があったことを示します。
- [23] [[330]] 番台はセッション記述中で要求された基本的なネットワーク・サービスに問題があることを示します。
- [24] [[370]] 番台はセッション記述中で要求された quantitative [[QoS]] 引数に問題があることを示します。
- [25] [[390]] 番台はその他です。
]FIG]

[18]
,[CODE(HTTP)[[[10]]]]	,Response is stale	,[RFC 2068]
,[CODE(HTTP)[[[11]]]]	,Revalidation failed	,[RFC 2068]
,[CODE(HTTP)[[[12]]]]	,Disconnected operation	,[RFC 2068]
,[CODE(HTTP)[[[13]]]]	,Heuristic expiration	,[RFC 2068]
,[CODE(HTTP)[[[14]]]]	,Transformation applied	,[RFC 2068]
,[CODE(HTTP)[[[99]]]]	,Miscellaneous warning	,[RFC 2068]
,[CODE(HTTP)[[[110]]]]	,Response is stale	,[RFC 2616]
,[CODE(HTTP)[[[111]]]]	,Revalidation failed	,[RFC 2616]
,[CODE(HTTP)[[[112]]]]	,Disconnected operation	,[RFC 2616]
,[CODE(HTTP)[[[113]]]]	,Heuristic expiration	,[RFC 2616]
,[CODE(HTTP)[[[199]]]]	,Miscellaneous warning	,[RFC 2616]
,[CODE(HTTP)[[[214]]]]	,Transformation applied	,[RFC 2616]
,[CODE(HTTP)[[[299]]]]	,Miscellaneous persistent warning	,[RFC 2616]
,[CODE(SIP)[[[300]]]]	,Incompatible network protocol	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[301]]]]	,Incompatible network address formats	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[302]]]]	,Incompatible transport protocol	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[303]]]]	,Incompatible bandwidth units	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[304]]]]	,Media type not available	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[305]]]]	,Incompatible media format	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[306]]]]	,Attribute not understood	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[307]]]]	,Session description parameter not understood	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[330]]]]	,Multicast not available	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[331]]]]	,Unicast not available	,"[RFC 2543], [RFC 3261]"
,[CODE(SIP)[[[370]]]]	,Insufficient bandwidth	,"[RFC 2543], [RFC 3261]"
,[CODE(HTTP)[[[380]]]]
,[CODE(HTTP)[[[381]]]]
,[CODE(SIP)[[[399]]]]	,Miscellaneous warning	,"[RFC 2543], [RFC 3261]"

[48] [[HTTP]] [SRC[>>66, >>67]] と [[SIP]] [SRC[>>47]] でそれぞれ [[IANA登録簿]]があります。

;; [68] [[HTTP]] の登録簿は [[RFC 7234]] で新設されました。

[71] 警告符号の一覧は >>70 の [[JSON]] ファイルにも含まれています。
[REFS[
- [70] [CITE@en[data-web-defs/headers.txt at master · manakai/data-web-defs]] ([TIME[2014-10-09 14:33:34 +09:00]] 版) <https://github.com/manakai/data-web-defs/blob/master/doc/headers.txt>
]REFS]

* 警告テキスト

[36] 警告テキスト ([CODE(ABNF)@en[warn-text]]) は、[[引用文字列]]です [SRC[>>3]]。

[FIG(railroad)[
= [[引用文字列]]
]FIG]

[60] 警告テキストは、[[エラー]]を説明するもので、例えば[[記録]]のために用いるものです。
この値は単なるヒントで、[[警告符号]]の解釈には影響しません。 [SRC[>>3]]

[65] [[警告符号]]には、それぞれ[RUBYB[推奨]@en[recommend]]される[[英語]]の警告テキストが定義されています
[SRC[>>3]]。しかしそれしか指定できないわけではありませんし、[[英語]]である必要もないようです。

[61] [[RFC 2616]] までは[[引用文字列]]内に[[符号化語]]を用いることができるとされていましたが、誰も実装していませんでした。
[[RFC 723x]] ではこの規定は削除されています。

;; [27] 
[CODE(ABNF)[warn-text]] は [[DQN]] な仕様だなぁ。
ここに [CODE(ABNF)[encoded-word]] を使ってもいい
ってことは、 [CODE(ABNF)[[[quoted-string]]]] の中身が 
[CODE(ABNF)[encoded-word]],
ということですよねぇ? (でないと構文に適合しないし、
[CODE(ABNF)[encoded-word]] が複数個になった時に面倒だし。)
でもそれは [[MIME]] の設計的には良いことではありません
[WEAK[(もちろん HTTP は MIME ではありませんが...)]]。

;; [62] [Q[[[RFC 2047]] の符号化方式]]らしいですけど、 [[RFC 2231]] の改訂
(言語指定) は適用されるのでしょうか。この仕様書は RFC 2616
ですから、 RFC 2231 の発行より後なのでして・・。

[28] [[SIP/2.0]] では [CODE(ABNF)[warn-text]] は [[UTF-8]] であり、 [CODE(ABNF)[encoded-word]]
が使えるとは書かれていません。使えないのでしょう。
[CODE(ABNF)[warn-text]] の既定の言語は 
[CODE(lang)[[[i-default]]]] です。

* 警告日時

[37] 警告日時 ([CODE(ABNF)@en[warn-date]]) は、 [CODE(ABNF)@en[[[HTTP-date]]]]
を [CODE(char)[[["]]]] で括ったものです [SRC[>>3]]。

[FIG(railroad)[
= [CODE(char)[[["]]]]
= [[HTTPの日時形式]]
= [CODE(char)[[["]]]]
]FIG]

;; [29] RFC 2068 では、 [CODE(ABNF)[warn-date]] は定義されていませんでした。
[CODE(ABNF)[warn-date]] は RFC 2616 で追加されました。

;; [57] RFC 2068 から分家した SIP/2.0 でも [CODE(ABNF)[warn-date]] 
は定義されていません。

[58] [CODE(HTTP)[[[1xx]]]] では警告日時を含めるべき条件が規定されています。

;; [CODE(HTTP)[[[1xx]]]] を参照。

[59] それ以外の場合について[[生成]]して良いとも悪いとも言及されていません。

* 処理

[41] [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]を受信した[[利用者エージェント]]は、
そのできるだけ多くを出現順で[[利用者]]に通知する[['''べきです''']] [SRC[>>3]]。

;; [44] 実際に表示する[[利用者エージェント]]があるのかは不明です。

[51] 具体的にどう表示するべきなのかは特に規定がないようです。

[52] 未知の[[警告符号]]の場合にどうするかは特に規定がありません。
また [[RFC 2068]] から [[RFC 2616]] への改訂時に構文が非互換変更されましたが、
それも含めて[[非妥当]]な [CODE(HTTP)@en[[[Warning:]]]]
[[ヘッダー]]を受信した時にどう処理するべきかは特に言及がありません。

;; [56] [[腐敗応答]]、[[条件付き要求]]、[[範囲要求]]も参照。

[63] [[受信者]]が [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]を利用、評価、表示する場合は、
警告日時が [CODE(HTTP)@en[[[Date:]]]] [[ヘッダー]]と異なっている場合、
[[蓄積]]、[[転送]]、利用の前に当該警告値を削除しなければ[['''なりません''']] [SRC[>>3]]。
すべての警告値を削除した場合には、 [CODE(HTTP)@en[[[Warning:]]]]
[[ヘッダー]]全体を削除しなければ[['''なりません''']] [SRC[>>3]]。

;; [64] これによって[[キャッシュ検証]]後に誤って残されている警告値を除去します [SRC[>>3]]。

;; [69] [CODE(HTTP)@en[[[Date:]]]] がない場合や警告日時がない場合は、
削除しなくて良いと思われます。

* 歴史

[26] [[RFC 2068]] で [[HTTP]] に導入された際には[[応答]]で用いる[[ヘッダー]]とされていました。

[53] [[RFC 2616]] ではこれが[[要求]]でも使えるように拡張されました。

[54] [[RFC 2068]] から派生した [[SIP]] では[[応答]]のみで使えることになっています。

;; [55] なお [[RTSP]] には [CODE(HTTP)@en[[[Warning:]]]] [[ヘッダー]]はありません。

[FIG(quote)[
[FIGCAPTION[
[4] RFC 2068 (HTTP/1.1) 14.45; RFC 2616 (HTTP/1.1) 14.46 Warning
]FIGCAPTION]

> The Warning [DEL[response-header]] [INS[general-header]] field is used to carry additional
information about the status [INS[or transformation]] of a response which [DEL[may]] [INS[might]] not
be reflected [DEL[by the response status code]] [INS[in the message]]. This information is typically[DEL[, though not exclusively,]]
used to warn about a possible lack of semantic
transparency from caching operations [INS[or transformations applied to the entity body of the message]].

[CODE(HTTP)[Warning]] [[一般頭欄]]は、[DEL[応答[[状態符号]]に]][INS[メッセージ中に]]反映されていないかもしれない応答の状態[INS[や変形]]についての追加情報を伝達するために使います。
この情報は、典型的にはキャッシュ操作の意味的透過性の欠如の可能性があること[INS[やメッセージの実体本体に変形が行われたこと]]を警告するために使います。

> Warning headers are sent with responses using:

[CODE(HTTP)[Warning]] 頭は、応答で次を使って送信します。

>
- Warning    = "Warning" ":" 1#warning-value
- warning-value = warn-code SP warn-agent SP warn-text [INS[ [SP warn-date] ]]
- [DEL[warn-code  = 2DIGIT]]
- [DEL[warn-code  = 3DIGIT]]
-warn-agent = ( host [ ":" port ] ) | pseudonym
[PRE[
; the name or pseudonym of the server adding
; the Warning header, for use in debugging
]PRE]
- warn-text  = quoted-string
- [INS[warn-date  = <"> HTTP-date <">]]

> A response [DEL[may]] [INS[MAY]] carry more than one Warning header.

応答は1つ以上の Warning 頭を運んで'''構いません'''。

> The warn-text [DEL[should]] [INS[SHOULD]] be in a natural language and character set that
is most likely to be intelligible to the human user receiving the response.
This decision [DEL[may]] [INS[MAY]] be based on any available knowledge,
such as the location of the cache or user, the Accept-Language field in a
request, the Content-Language field in a response, etc.
The default language is English and the default character set is ISO-8859-1.

warn-text は応答を受け取る人間利用者が理解可能と最も思われる
自然言語と文字集合を使う'''べきです'''。この決定はいかなる利用可能な知識、
例えばキャッシュや利用者の位置, 要求の Accept-Language 欄,
要求の Content-Language 欄, などなどを基にして'''構いません'''。
既定言語は英語で既定文字集合は ISO-8859-1 です。

> If a character set other than ISO-8859-1 is used, it MUST be encoded
in the warn-text using the method described in RFC [DEL[1522]] [INS[2047]] [14].

ISO-8859-1 以外の文字集合が使われる場合は、 RFC 2047
で説明されている方法を使って warn-text を符号化しなければ'''なりません'''。

> [INS[Warning headers can in general be applied to any message, however some specific warn-codes are specific to caches and can only be applied to response messages.]] [DEL[Any server or cache may add Warning headers to a response.]]
New Warning headers [DEL[should]] [INS[SHOULD]] be added
after any existing Warning headers. A cache MUST NOT delete any Warning header
that it received with a [DEL[response]] [INS[message]]. However, if a cache successfully validates a
cache entry, it SHOULD remove any Warning headers previously attached to that 
entry except as specified for specific Warning codes.
It MUST then add any Warning headers received in the validating response.
In other words, Warning headers are those that would be attached to
the most recent relevant response.

[CODE(HTTP)[Warning]] 頭は、一般に任意のメッセージに適用できます。
しかし、幾つかの特定の [CODE(ABNF)[warn-code]] は[[キャッシュ]]に特有のものであり、
応答メッセージにのみ適用できます。
新しい [CODE(HTTP)[Warning]] 頭は既存の [CODE(HTTP)[Warning]]
頭群の後に追加する'''べきです'''、[[キャッシュ]]は、
その受信したメッセージ内の [CODE(HTTP)[Warning]] 頭を削除しては'''なりません'''。
しかし、キャッシュがキャッシュ項目を成功裏に[[妥当性検証]]したのなら、
特定の [CODE(HTTP)[Warning]] 符号について指定されたものを除いて、
その項目に以前に付された [CODE(HTTP)[Warning]] 頭群んは削除する'''べきです'''。
キャッシュは、その際に検証応答で受信した [CODE(HTTP)[Warning]]
頭欄をすべて追加しなければ'''なりません'''。言い換えれば、
[CODE(HTTP)[Warning]] 頭は最近の関係する応答に付されたものとします。

> When multiple Warning headers are attached to a response, the user
agent [DEL[SHOULD display]] [INS[ought to inform the user of]] as many of them as possible, in the order that
they appear in the response. If it is not possible to [DEL[display]] [INS[inform the user of]] all of
the warnings, the user agent [DEL[should]] [INS[SHOULD]] follow these heuristics:

複数の [CODE(HTTP)[Warning]] 頭群が応答に付されている時は、
[[利用者エージェント]]はそのうちのできるだけ多くを、
応答に出現した順で[[利用者]]に示すべきです。
警告のすべてを利用者に示すことが不可能である時は、
利用者エージェントは次の発見的方法に従う'''べきです'''。

>
- [DEL[o]] [INS[-]] Warnings that appear early in the response take priority over
those appearing later in the response.
- [DEL[o]] [INS[-]] Warnings in the user's preferred character set take priority
over warnings in other character sets but with identical warn-codes
and warn-agents.

- 応答の先のほうで現れた [CODE(HTTP)[Warning]] は、
応答の後のほうで現れたものよりも優先させる
- 利用者の優先させている文字集合で書かれた [CODE(HTTP)[Warning]]
は、 [CODE(ABNF)[warn-code]] と [CODE(ABNF)[warn-agent]] が同じでありながらも他の文字集合で書かれたものよりも優先させる。

> Systems that generate multiple Warning headers [DEL[should]] [INS[SHOULD]] order them with
this user agent behavior in mind.

複数の [CODE(HTTP)[Warning]] 頭を生成するシステムは、この利用者エージェントの振る舞いを念頭に置いて順序を決める'''べきです'''。

[INS[
> Requirements for the behavior of caches with respect to Warnings are
stated in section 13.1.2.

[CODE(HTTP)[Warning]] に関する[[キャッシュ]]の振る舞いの要件は13.1.2節で述べています。
]INS]

> This is a list of the currently-defined warn-codes, each with a
recommended warn-text in English, and a description of its meaning.

これは、現在定義されている [CODE(ABNF)[warn-code]] と、それぞれについての推奨する英語での [CODE(ABNF)[warn-text]] とその意味の説明の一覧です。

>
:[INS[1]]10 Response is stale:
MUST be included whenever the returned response is stale. [DEL[A cache may add this warning to any response, but may never remove it until the response is known to be fresh.]]

: 110 応答は腐っています : 返される応答が[[腐敗]]しているときには必ず含めなければ'''なりません'''。[DEL[キャッシュはこの警告を任意の応答に追加して構いませんが、応答が[[新鮮]]と分かるまでは決して削除してはなりません。]]

>
:[INS[1]]11 Revalidation failed:
MUST be included if a cache returns a stale response because an
attempt to revalidate the response failed, due to an inability to reach the server. [DEL[A cache may add this warning to any response, but may never remove it until the response is successfully revalidated.]]

: 111 再検証失敗 : キャッシュが、[[鯖]]に到達する能力がなかったために応答の妥当性を再検証する試行に失敗したため、腐った応答を返すときに含めなければ'''なりません'''。[DEL[キャッシュはこの警告を任意の応答に追加して構いませんが、応答を成功裏に再検証するまでは決して削除してはなりません。]]

>
:[INS[1]]12 Disconnected operation:
SHOULD be included if the cache is intentionally disconnected from
the rest of the network for a period of time.

: 112 未接続操作 : キャッシュがある時間中ネットワークの他の部分と意図的に接続されていないときに含める'''べきです'''。

>
:[INS[1]]13 Heuristic expiration:
MUST be included if the cache heuristically chose a freshness
lifetime greater than 24 hours and the response's age is greater
than 24 hours.

: 113 発見的満期 : キャッシュが発見的に24時間よりも大きな[[新鮮寿命]]を選び、
応答の[[齢]]が24時間よりも大きいときに含めなければ'''なりません'''。

>
:[INS[1]]99 Miscellaneous warning:
The warning text [DEL[may]] [INS[MAY]] include arbitrary information to be presented
to a human user, or logged. A system receiving this warning MUST NOT take any automated action[INS[, besides presenting the warning to the user]].

: 119 その他の警告 : 警告文は、人間利用者に示される、または記録される、任意の情報を含めて'''構いません'''。
この警告を受信したシステムは、[INS[利用者に警告を示す他に、]]自動の動作を行っては'''なりません'''。

>
:[INS[2]]14 Transformation applied:
MUST be added by an intermediate cache or proxy if it applies any
transformation changing the content-coding (as specified in the
Content-Encoding header) or media-type (as specified in the
Content-Type header) of the response, [INS[or the entity-body of the response,]]
unless this Warning code already appears in the response. [DEL[MUST NOT be deleted from a response even after revalidation.]]

: 214 変形適用済み : [[中間キャッシュ]]または[[串]]が、応答の
[CODE(ABNF)[[[content-coding]]]] ([CODE(HTTP)[[[Content-Encoding]]]]
頭で指定されます。) または [CODE(ABNF)[[[media-type]]]]
([CODE(HTTP)[[[Content-Type]]]] で指定されます。) [INS[または応答の [CODE(ABNF)[[[entity-body]]]]]]
を変更する何らかの変形を適用した場合に、
この [CODE(HTTP)[Warning]] 符号が既に応答に現れている場合を除き、
追加しなければ'''なりません'''。[DEL[再検証の後であっても応答から削除しては'''なりません'''。]]

[INS[
>
:299 Miscellaneous persistent warning:
The warning text MAY include arbitrary information to be presented
to a human user, or logged. A system receiving this warning MUST
NOT take any automated action.

: 299 その他の持続警告 : 警告文は、人間利用者に示される、または記録される、任意の情報を含めて'''構いません'''。
この警告を受信したシステムは、[INS[利用者に警告を示す他に、]]自動の動作を行っては'''なりません'''。

> If an implementation sends a message with one or more Warning headers
whose version is HTTP/1.0 or lower, then the sender MUST include in
each warning-value a warn-date that matches the date in the response.

実装が一つ以上の [CODE(HTTP)[Warning]] 頭群を含んだ版が HTTP/1.0 以下のメッセージを送信するときには、
送信者は各 [CODE(ABNF)[warning-value]] に応答の日付と一致する
[CODE(ABNF)[warn-date]] を含めなければ'''なりません'''。

> If an implementation receives a message with a warning-value that
includes a warn-date, and that warn-date is different from the Date
value in the response, then that warning-value MUST be deleted from
the message before storing, forwarding, or using it. (This prevents
bad consequences of naive caching of Warning header fields.) If all
of the warning-values are deleted for this reason, the Warning header
MUST be deleted as well.

実装が [CODE(ABNF)[warn-date]] を含む [CODE(ABNF)[warning-value]]
を含み、その [CODE(ABNF)[warn-date]] が応答の [CODE(HTTP)[[[Date]]]]
値と異なるメッセージを受信したら、その [CODE(ABNF)[warning-value]]
は、そのメッセージを蓄積、転送、または使用する前にメッセージから削除しなければ'''なりません'''。
(これは、 [CODE(HTTP)[Warning]] 頭欄を単純にキャッシュすることによる悪影響を防ぎます。)
すべての [CODE(ABNF)[warning-value]] がこの理由により削除される場合は、
[CODE(HTTP)[Warning]] 頭も同様に削除しなければ'''なりません'''。
]INS]
]FIG]

* 例

[FIG[
[FIGCAPTION[
>>3
]FIGCAPTION]

>
[PRE(HTTP code)[
Warning: 112 - "network down" "Sat, 25 Aug 2012 23:34:45 GMT"
]PRE]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[19] [CITE@en[Zalando RESTful API と イベントスキーマのガイドライン]]
([TIME[2018-06-20 22:30:22 +09:00]])
<https://restful-api-guidelines-ja.netlify.com/>
]FIGCAPTION]

> 廃止予定フェーズの間、 Warning ヘッダを付けましょう。 (RFC 7234 - Warning header をみてください)。 Warning が付いていたら、 warn-code は 299 を指定し、 warn-text は "The path/operation/parameter/… {name} is deprecated and will be removed by {date}. Please see {link} for details." の形式にしましょう。 link先は、なぜAPIがもはやサポートされないかと、クライアントがすべきことを記述した ドキュメントにします。 `Warning`ヘッダを付加しても、クライアントに対しAPI停止の同意を得たとはいえません。

]FIG]

[20] [CITE@en[Warning: header & stale-while-revalidate · Issue #913 · whatwg/fetch]]
([TIME[2019-06-27 14:22:19 +09:00]])
<https://github.com/whatwg/fetch/issues/913>

[31] [CITE@en[draft-ietf-http-warning-00 - Problem with HTTP/1.1 Warning header, and proposed fix]]
([TIME[2019-06-25 05:25:15 +09:00]])
<https://tools.ietf.org/html/draft-ietf-http-warning-00>

[32] [CITE@en[Warning · Issue #139 · httpwg/http-core]]
([TIME[2019-06-27 14:23:19 +09:00]])
<https://github.com/httpwg/http-core/issues/139>

Historical Legal Sensitive Parent: [Help / License]

Edit

Page

Page name(s)