-
Notifications
You must be signed in to change notification settings - Fork 4
/
798.txt
54 lines (37 loc) · 2.6 KB
/
798.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
[9] [CODE(HTTP)@en[[[Prefer:]]]] [[ヘッダー]]の値 [DFN[[CODE(HTTP)@en[[[respond-async]]]]]]
は、最終的な処理の完了を待たずに[[非同期的]]に[[最後の応答]]を返すべきことを示します。
* 仕様書
[REFS[
- [3] '''[CITE@en[RFC 7240 - Prefer Header for HTTP]] ([TIME[2014-07-26 04:24:01 +09:00]] 版) <https://tools.ietf.org/html/rfc7240#section-4.1>'''
- [1] [CITE@en[RFC 7240 - Prefer Header for HTTP]] ([TIME[2014-07-26 04:24:01 +09:00]] 版) <https://tools.ietf.org/html/rfc7240#section-2>
- [12] [CITE[OData Version 4.0 Part 1: Protocol Plus Errata 01]] ([TIME[2014-09-04 16:00:00 +09:00]] 版) <http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html#_Toc370374813>
]REFS]
* 意味
[4] [[好み]] [CODE(HTTP)@en[[[respond-async]]]] は、
[[鯖]]が[[非同期的]]に[[応答]]を送信することを[[クライアント]]が好むことを示します
[SRC[>>3]]。
* 構文
[6] 値や[[引数]]は無い [SRC[>>3]] ものとして定義されています。
* 処理モデル
[7] [[鯖]]は、[[非同期的]]に[[応答]]を返す場合には [CODE(HTTP)[[[202]]]] [[応答]]を送信することができます。
[8] [CODE(HTTP)[[[202]]]] をいつどのように使うかは仕様の範囲外 [SRC[>>3]] とされています。
[EG[
[5] 例えば[[鯖]]は[[応答]]の[[生成]]に一定の閾値以上の時間がかかる時は、
[CODE(HTTP)@en[[[Prefer:]] [[respond-async]]]] に従って [CODE(HTTP)[[[202]]]]
[[応答]]を返すことができます [SRC[>>3]]。
]EG]
[2] [[串]]は [CODE(HTTP)@en[[[Prefer:]] [[respond-async]]]] を独自に処理して構いません。
[[起源鯖]]の[[応答]]を待たずに [CODE(HTTP)[[[202]]]] [[応答]]を返すことができます。 [SRC[>>1]]
[10] [CODE(HTTP)@en[[[Prefer:]] [[wait]]]] が指定されている場合、
その指定[[秒]]数以内に[[応答]]を返せない時に [CODE(HTTP)[[[202]]]]
を返しつつ[[非同期的]]に処理を続けられます。
;; [CODE(HTTP)@en[[[wait]]]] を参照。
* 関連
[11] [CODE(HTTP)@en[[[respond-async]]]] が指定されている時には、
[CODE(HTTP)@en[[[odata.callback]]]] も指定できます [SRC[>>12]]。
[203] [CITE[OData Version 4.0 Part 1: Protocol Plus Errata 01]]
( ([TIME[2014-09-04 16:00:00 +09:00]] 版))
<http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html#_Toc399426736>
[204] [CITE[OData Version 4.0 Part 1: Protocol Plus Errata 01]]
( ([TIME[2014-09-04 16:00:00 +09:00]] 版))
<http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html#_Toc393958809>