-
Notifications
You must be signed in to change notification settings - Fork 4
/
948.txt
182 lines (131 loc) · 7.78 KB
/
948.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
[12] [DFN[[CODE(HTTP)@en[[[IM:]]]]]] [[ヘッダー]]は、適用されている[[実現値操作]]を表します。
* 仕様書
[REFS[
- [2] [CITE@en[RFC 3229 - Delta encoding in HTTP]] ([TIME[2014-10-26 21:15:25 +09:00]] 版) <http://tools.ietf.org/html/rfc3229#section-10.3>
- [1] '''[CITE@en[RFC 3229 - Delta encoding in HTTP]] ([TIME[2014-10-26 21:15:25 +09:00]] 版) <http://tools.ietf.org/html/rfc3229#section-10.5.2>'''
]REFS]
* 意味
[3] [CODE(HTTP)@en[[[IM:]]]] [[ヘッダー]]は、[[応答]]が表す[[実現値]]に対して適用されている[[実現値操作]]を示します [SRC[>>1]]。
* 構文
[5] [CODE(HTTP)@en[[[IM:]]]] [[ヘッダー]]の値は、0個以上の[[実現値操作]]の指定の[[リスト]]
([CODE(HTTP)[[[#]]]]) です [SRC[>>1]]。
[FIG(railroad)[
= ?
== [[実現値操作]]
== *
=== [[OWS]]
=== [CODE(HTTP)[[[,]]]]
=== [[OWS]]
=== [[実現値操作]]
]FIG]
[13] [[実現値操作]]の記述の順序は、[[実現値]]に対して操作を適用した順序を表しています。
[15] 適用する[[実現値操作]]の決定については、 [CODE(HTTP)@en[[[A-IM:]]]]
を参照。
* 文脈
[4] [[差分符号化]]した [CODE(HTTP)[[[226]]]] [[応答]]の [CODE(HTTP)@en[[[IM:]]]] [[ヘッダー]]には使用した[[差分符号化]]を明記しなければ[['''なりません''']] [SRC[>>2]]。
[6] [[実現値操作]]として[[範囲]]選択と[[恒等]]でない[[実現値操作]]が両方適用される時は、
[CODE(HTTP)@en[[[IM:]]]] [[ヘッダー]]でその適用順序を指定しなければ[['''なりません''']] [SRC[>>1]]。
[9] [[実現値操作]]が [CODE(HTTP)@en[[[range]]]] のみの場合は、
[CODE(HTTP)@en[[[IM:]]]] [[ヘッダー]]は省略する[['''べきです''']]。
その場合通常は [CODE(HTTP)[[[206]]]] を使います。 [SRC[>>1]]
;; [11] [CODE(HTTP)[[[226]]]] を使うことも禁止されていないということでしょうか。
[7] [CODE(HTTP)@en[[[IM:]]]] に [CODE(HTTP)@en[[[range]]]] が含まれる時は、
[CODE(HTTP)@en[[[Content-Range:]]]] [[ヘッダー]]か
[CODE(HTTP)@en[[[Content-Type:]] [[multipart/byteranges]]]]
を含まなければ[['''なりません''']] [SRC[>>1]]。
[8] [CODE(HTTP)@en[[[IM:]]]] を指定した[[応答]]の[[状態符号]]は
[CODE(HTTP)[[[226]]]] でなければ[['''なりません''']] [SRC[>>1]]。
[14] この[[ヘッダー]]は複数指定できます。
* 処理モデル
[16] [[キャッシュ]]における処理については、[CODE(HTTP)[[[226]]]] を参照。
* 歴史
** RFC 3229
[FIG(quote)[
[FIGCAPTION[
[17] RFC 3229 (差分符号化) 10.5.2 IM
]FIGCAPTION]
> The IM response-header field is used to indicate the instance-manipulations, if any, that have been applied to the instance
represented by the response. Typical instance manipulations include
delta encoding and compression.
[CODE(HTTP)[IM]] [[応答頭欄]]は、[[応答]]で表現される[[実現値]]に[[実現値操作]]が適用されていれば、これを示すために使用します。
典型的な実現値操作には[[差分符号化]]や[[圧縮]]が含まれます。
>
- IM = "IM" ":" #(instance-manipulation)
> Instance-manipulations are defined in section 10.1.
実現値操作は10.1節で定義しています。
> As a special case, if the instance-manipulations include both range
selection and at least one other non-identity instance-manipulation,
the IM header field MUST be used to indicate the order in which all
of these instance-manipulations, including range selection, were
applied. If the IM header lists the "range" instance-manipulation,
the response MUST include either a Content-Range header or a
multipart/byteranges Content-Type in which each part contains a
Content-Range header. (See section 10.10 for specific discussion of
combining delta encoding and multipart/byteranges.)
特別な場合として、実現値操作が範囲選択と最低一つの他の非[[同一]]実現値操作を含む場合、 [CODE(HTTP)[IM]] 頭欄はどの順序で範囲選択を含む実現値操作が適用されたのかを示すために使用しなければ'''なりません'''。
[CODE(HTTP)[IM]] 頭が [CODE(HTTP)[[[range]]]] 実現値操作を挙げているなら、
応答は [CODE(HTTP)[[[Content-Range]]]] 頭を含んでいるか、
各[[部分]]が [CODE(HTTP)[Content-Range]] 頭を含む
[CODE(MIME)[[[multipart/byteranges]]]] [CODE(HTTP)[[[Content-Type]]]]
でなければ'''なりません'''。 (差分符号化と [CODE(MIME)[multipart/byteranges]] の組み合わせについての議論は10.10節を参照。)
> Responses that include an IM header MUST carry a response status code
of 226 (IM Used), as specified in section 10.4.1.
[CODE(HTTP)[IM]] 頭を含む応答は10.4.1節で規定されている通り
[CODE(HTTP)[[[226]]]] ([ABBR[IM]] 使用中) 応答[[状態符号]]を運搬しなければ'''なりません'''。
> The server SHOULD omit the IM header if it would list only the
"range" instance-manipulation. Such responses would normally be sent
with response status code 206 (Partial Content), as specified by
HTTP/1.1 [10].
[[鯖]]は、 [CODE(HTTP)[IM]] 頭が [CODE(HTTP)[[[range]]]]
実現値操作だけを挙げることになるときには [CODE(HTTP)[IM]]
頭を省略する'''べきです'''。そのような応答は通常 HTTP/1.1
で規定されている通り応答状態符号 [CODE(HTTP)[[[206]]]] (部分内容)
で送信されます。
> Examples of the use of the IM header include:
[CODE(HTTP)[IM]] 頭の使用例
>
- IM: vcdiff
> This example indicates that the entity-body is a delta encoding of
the instance, using the vcdiff encoding.
この例は [CODE(ABNF)[[[entity-body]]]] が [CODE(HTTP)[[[vcdiff]]]] 符号化を使った[[差分符号化]]であることを示します。
>
[PRE[
IM: diffe, deflate, range
]PRE]
> This example indicates that the instance has first been delta-encoded
using the diffe encoding, then the result of that has been compressed
using deflate, and finally one or more ranges of that compressed
encoding have been selected.
この例は最初に [CODE(HTTP)[[[diffe]]]] 符号化を使って差分符号化して、
その結果を [CODE(HTTP)[[[deflate]]]] を使って圧縮して、
最後にその圧縮符号化の一つ以上の範囲を選択していることを示します。
>
[PRE[
IM: range, vcdiff
]PRE]
> This example indicates that one or more ranges of the instance have
been selected, and the result has then been delta encoded against
identical ranges of a previous base instance.
この例は一つ以上の実現値の範囲が選択され、
その結果が以前の[[基底実現値]]の同じ範囲について差分符号化されていることを示します。
> A cache using a response received in reply to one request to reply to
a subsequent request MUST follow the rules in section 10.6 if the
cached response includes an IM header field.
ある要求に対して受信した応答を後の要求で使用する[[キャッシュ]]は、
キャッシュした応答が [CODE(HTTP)[IM]] 頭欄を含む場合には、
10.6 節の規則に従わなければ'''なりません'''。
]FIG]
** RFC 4229
[27] [[RFC 4229]] は[[IANA登録簿]]に状態「[[標準]]」で登録しています [SRC[>>26]]。
[REFS[
- [26] [CITE@en[RFC 4229 - HTTP Header Field Registrations]] ([TIME[2014-11-02 18:53:20 +09:00]] 版) <http://tools.ietf.org/html/rfc4229#section-2.1.52>
]REFS]
* 例
[10]
[PRE(HTTP code)[
IM: diffe, deflate, range
]PRE]
... は、[[実現値]]の [CODE(HTTP)@en[[[diffe]]]] による[[差分]]を
[CODE(HTTP)@en[[[deflate]]]] で[[圧縮]]し、
[[範囲要求]]を適用した結果が含まれることを表します [SRC[>>1]]。
]FIG]