Slug

Slug

[1] Slug: 頭欄は、 作成される資源URL の決定時のヒントを表します。

仕様書

意味

[3] Slug: POST 要求に含まれている場合、その値は作成されるエントリー資源媒体資源が通常取り出しされる際に使われる URI の一部分としてクライアントが望む値を表します。 AtomPub

構文

[5] AtomPub より:

       LWS      = <defined in Section 2.2 of [RFC2616]>
       slugtext = %x20-7E | LWS
       Slug     = "Slug" ":" *slugtext

[6] 値は RFC 3629 UTF-8符号化し、 RFC 3986 百分率符号化を施した値とされています。 AtomPub

文脈

[12] AtomPub要求で使われます。

[13] それ以外でも稀に使われるようです (>>8>>10)。

処理

[4] は新しく作成する資源成員URI を作成する時にこのの値を使って構いません。 例えば、その値の一部または全部を URI の最後の segment に使うことができます。 atom:id媒体リンク・エントリーtitle にも使って構いませんはこのを無視しても構いません。 値の一部の文字を置き換えるなど変形させても構いませんAtomPub

[7] AtomPub より

       POST /myblog/entries HTTP/1.1
       Host: example.org
       Content-Type: image/png
       Slug: The Beach at S%C3%A8te
       Authorization: Basic ZGFmZnk6c2VjZXJldA==
       Content-Length: nnn

       ...binary data...

関連

[11] フォーム提出など multipart/form-dataファイルを送信する場合には、 Content-Disposition ヘッダーfilename 引数ファイル名が指定されますから、サーバーはそれをヒントに使えます。

[14] ダウンロードファイル名の指定には、応答Content-Disposition: ヘッダーfilename 引数や、リンク元HTMLa 要素download 属性が使えます。

メモ

[8] Protocol Guide (v3.0) - Google Documents List Data API v3.0 - Google Code ( 版) <http://code.google.com/intl/ja-JP/apis/documents/docs/3.0/developers_guide_protocol.html>

[9] Developer's Guide: JSON-C / JavaScript - YouTube — Google Developers ( ( 版)) <https://developers.google.com/youtube/2.0/developers_guide_jsonc?hl=ja&csw=1>

[10] Linked Data Platform 1.0 ( 版) <https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp.html#h-ldpc-post-slug>

5.2.3.10 LDP servers may allow clients to suggest the URI for a resource created through POST, using the HTTP Slug header as defined in [RFC5023]. LDP adds no new requirements to this usage, so its presence functions as a client hint to the server providing a desired string to be incorporated into the server's final choice of resource URI.

[15] Web Annotation Protocol () <https://w3c.github.io/web-annotation/protocol/wd/#h-suggesting-an-iri-for-an-annotation>

The IRI path segment that is appended to the Container IRI for a resource may be suggested by the Annotation Client by using the Slug HTTP header on the request when the resource is created. The server should use this name, so long as it does not already identify an existing resource, but may ignore it and use an automatically assigned name.

[16] OSLC Core Version 3.0. Part 5: Attachments () <http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/cs01/part5-attachments/oslc-core-v3.0-cs01-part5-attachments.html>

5.4.2 Clients may use the HTTP Slug request header [RFC5023] to suggest a name when creating an attachment. If present, the Slug header should not include a file extension.