[2] Prefer: ヘッダー の好み字句
return 応答 で返すべき表現 の種類を表すものです。
仕様書 [1] RFC 7240 - Prefer Header for HTTP (2014-07-26 04:24:01 +09:00 版) https://tools.ietf.org/html/rfc7240#section-4.2 [15] Linked Data Platform 1.0 (2014-10-27 09:56:06 +09:00 版) https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp.html#prefer-parameters 意味 [5] 鯖 は POST PUT 要求 を処理して成功した後に、
操作の状態を説明した表現 を返すこともできますし、
変更後の資源 自体の表現 を返すこともできます。
どちらにするかは鯖 が決めることですが、 return クライアント の希望を伝えることができます。>>1
構文 [3] return representation minimal secure-representation return-no-content return-content
[7] 値は大文字・小文字不区別 です >>1
引数 [16] RFC では引数 は定義されていませんが、 LDP が2つの引数 を追加しています
>>15
[17] どちらも値は URL のリストとなっています >>15
[18] しかし LDP 以外で使えなそうな引数 を一般的な名前で追加しちゃって好き放題ですね... 他ではそうそう使われないでしょうから、現実的には衝突の虞もないでしょうが...処理モデル [6] Prefer: return 起源鯖 は、
指定された値に従って応答 をどのような内容にするか決定することになります。
[8] return =minmal return =representation >>1
[9] これは Prefer: ヘッダー 全体の処理モデル、
すなわち同じ好み字句 が複数指定された場合に最初のもの以外は無視される、
というものと矛盾するようですが・・・。[4] どちらを採用したかは、応答 の Preference-Applied: ヘッダー で明示できます。
歴史 [12] Microsoft の OData は return=minimal return-no-content return=representation return-content
[13] こちらの方がよりわかりやすい名前ですね。[14] OASIS の OData 仕様は RFC の return >>10
[11] 2.2.5.9 Prefer (2014-10-27 09:40:54 +09:00 版) http://msdn.microsoft.com/en-us/library/hh537533.aspx [10] OData Version 4.0 Part 1: Protocol Plus Errata 01
( (2014-09-04 16:00:00 +09:00 版))
http://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html#_Toc370374818 [19] draft-murchison-webdav-prefer-07 - Use of the Prefer Header Field in Web Distributed Authoring and Versioning (WebDAV)
( (2014-10-16 14:20:11 +09:00 版))
http://tools.ietf.org/html/draft-murchison-webdav-prefer-07
[20] draft-daboo-caldav-attachments-03 - CalDAV Managed Attachments
( (2014-10-16 11:57:42 +09:00 版))
http://tools.ietf.org/html/draft-daboo-caldav-attachments-03