/
191.txt
139 lines (102 loc) · 6.17 KB
/
191.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
[1] [DFN[[CODE(HTTP)@en[[[TE:]]]]]] [[ヘッダー]]は、[[クライアント]]が受け付ける意志がある[[転送符号化]]を表します。
* 仕様書
[REFS[
- [2] [CITE@en[RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing]] ([TIME[2014-06-07 01:59:35 +09:00]] 版) <https://tools.ietf.org/html/rfc7230#section-4.3>
]REFS]
* 文脈
[4] この[[ヘッダー]]は、複数指定できます。
[15] [[送信者]]は [CODE(HTTP)@en[[[TE:]]]] を用いるときは
[CODE(HTTP)@en[[[Connection:]]]] に [CODE(HTTP)[[[TE]]]]
を含めなければ[['''なりません''']] [SRC[>>2]]。
* 構文
[3] この[[ヘッダー]]の値は0個以上の値の[[リスト]] ([CODE[#]]) です。
[[リスト]]の各項目は[[転送符号化]]の名前と[[引数]]です。 [SRC[>>2]]
;; [5] [[転送符号化]]の項を参照してください。
[6] 名前として [CODE(HTTP)@en[[[chunked]]]] を指定しては[['''なりません''']] [SRC[>>2]]。
;; [7] [[HTTP/1.1]] では [CODE(HTTP)@en[[[chunked]]]] への対応は必須となっているので、
明記する必要性がありません。
[8] [[転送符号化]]のかわりに特別な値 [CODE(HTTP)@en[[[trailers]]]]
([[大文字・小文字不区別]]) を指定することができます [SRC[>>2]]。
[9] 仕様上完全に明確ではありませんが、 [CODE(HTTP)@en[[[trailers]]]]
には[[引数]]を指定できないようです。
[10] [[転送符号化]]の名前と[[引数]]の後には、特別な [CODE(HTTP)[[[q]]]]
[[引数]]を指定できます。詳しくは [CODE(HTTP)[[[q]]]] の項を参照してください。
* 意味
[12] [[転送符号化]]を使用しないことは、常に受け入れられると考えます [SRC[>>2]]。
[11] [CODE(HTTP)[[[TE:]]]] [[ヘッダー]]がないか、空の時は、
[CODE(HTTP)[[[chunked]]]] [[符号化]]のみ受け入れられることを表します [SRC[>>2]]。
[13] 複数の[[転送符号化]]を受け入れられるときは、 [CODE(HTTP)@en[[[q]]]]
[[引数]]があればその値が優先度を表します。
;; [14] [CODE(HTTP)[[[q]]]] [[引数]]がないときや、同位の値があるときの解釈は明記されていません。
* 歴史
[FIG[
[FIGCAPTION[
RFC 2616 (HTTP/1.1) 14.39 TE
]FIGCAPTION]
> The TE request-header field indicates what extension transfer-codings
it is willing to accept in the response and whether or not it is
willing to accept trailer fields in a chunked transfer-coding. Its
value may consist of the keyword "trailers" and/or a comma-separated
list of extension transfer-coding names with optional accept
parameters (as described in section 3.6).
TE 要求頭欄は、応答でどの拡張転送符号化を受け入れる意思があるかや、
chunked (塊) 転送符号化で trailers 欄を受け入れる意思があるか否か
を示します。値は、キーワード「trailers」と読点(comma)区切りの
拡張転送符号化の名前, 必要があれば受け入れパラメーター (3.6節で説明)
の一覧の両方または一方を取ることが出来ます。
[PRE[
TE = "TE" ":" #( t-codings )
t-codings = "trailers" | ( transfer-extension [ accept-params ] )
]PRE]
The presence of the keyword "trailers" indicates that the client is
willing to accept trailer fields in a chunked transfer-coding, as defined in
section 3.6.1. This keyword is reserved for use with transfer-coding
values even though it does not itself represent a transfer-coding.
「trailers」キーワードが現れた場合、クライアントは chunked (塊)
転送符号化において3.6.1節で定義されたように、 trailers 欄を
受け入れる意思があることを示します。このキーワードは、転送符号化を
表すものではありませんが、転送符号化値と同様に使うのに予約します。
Examples of its use are: 使用例:
- TE: deflate
- TE:
- TE: trailers, deflate;q=0.5
The TE header field only applies to the immediate connection.
Therefore, the keyword MUST be supplied within a Connection header
field (section 14.10) whenever TE is present in an HTTP/1.1 message.
TE 頭欄は、直後の接続にのみ適用されます。ですから、
TE が HTTP/1.1 メッセージ中に出現する場合は必ず、キーワードが
Connection 頭欄 (14.10節) 中にも供給され'''なければなりません'''。
A server tests whether a transfer-coding is acceptable, according to
a TE field, using these rules:
サーバーは、 TE 欄により次の規則を使って、転送符号化が使えるかどうかを
確認します。
1. The "chunked" transfer-coding is always acceptable. If the keyword
"trailers" is listed, the client indicates that it is willing to accept
trailer fields in the chunked response on behalf of itself and any downstream
clients. The implication is that, if given, the client is stating that either
all downstream clients are willing to accept trailer fields in the forwarded
response, or that it will attempt to buffer the response on behalf of
downstream recipients.
[PRE[
Note: HTTP/1.1 does not define any means to limit the size of a
chunked response such that a client can be assured of buffering
the entire response.
]PRE]
[PRE[
2. If the transfer-coding being tested is one of the transfer-
codings listed in the TE field, then it is acceptable unless it
is accompanied by a qvalue of 0. (As defined in section 3.9, a
qvalue of 0 means "not acceptable.")
]PRE]
[PRE[
3. If multiple transfer-codings are acceptable, then the
acceptable transfer-coding with the highest non-zero qvalue is
preferred. The "chunked" transfer-coding always has a qvalue
of 1.
]PRE]
If the TE field-value is empty or if no TE field is present, the only
transfer-coding is "chunked". A message with no transfer-coding is always
acceptable.
TE 欄値が空か、 TE 欄が存在しない場合、転送符号化「chunked」(塊)
だけが使えます。転送符号化の無いメッセージは常に認められます。
]FIG]