メインコンテンツまでスキップ

14. XML Element Definitions (XML要素定義)

本セクションでは、WebDAVプロトコルメッセージで使用されるすべてのXML要素を定義します。すべての要素はDAV:名前空間にあり、セクション17のルールに従って拡張できます。

コアXML要素(30個の定義)

14.1 activelock

目的: リソースのロックを記述します。

<!ELEMENT activelock (lockscope, locktype, depth, owner?, timeout?, locktoken?, lockroot)>

14.2 allprop

目的: すべてのデッドプロパティとライブプロパティの名前と値を返すことを指定します。

<!ELEMENT allprop EMPTY >

14.3 collection

目的: 関連するリソースがコレクションであることを識別します。DAV:resourcetypeプロパティに含める必要があります (MUST)。

<!ELEMENT collection EMPTY >

14.4 depth

目的: XMLコンテンツで深度値を表現します。

: "0" | "1" | "infinity"

<!ELEMENT depth (#PCDATA) >

14.5 error

目的: 403/409レスポンスの詳細なエラー情報を提供します。子要素は前提条件/事後条件コードを識別します。

<!ELEMENT error ANY >

14.6 exclusive

目的: 排他ロックを指定します。

<!ELEMENT exclusive EMPTY >

14.7 href

目的: URIまたは相対参照を含める必要があります (MUST)。

<!ELEMENT href (#PCDATA)>

14.8 include

目的: 子要素は、PROPFIND応答に含めるプロパティ名を表します (allpropと共に使用)。

<!ELEMENT include ANY >

14.9 location

目的: multistatusレスポンスでLocationヘッダー値を提供します。

<!ELEMENT location (href)>

14.10 lockentry

目的: リソースで使用できるロックタイプを定義します。

<!ELEMENT lockentry (lockscope, locktype) >

14.11 lockinfo

目的: LOCKメソッドで要求されるロックのタイプを指定するために使用されます。

<!ELEMENT lockinfo (lockscope, locktype, owner?)  >

14.12 lockroot

目的: ロックのルートURL (LOCKリクエストで使用されたURL) を含みます。

<!ELEMENT lockroot (href) >

14.13 lockscope

目的: ロックが排他的か共有かを指定します。

<!ELEMENT lockscope (exclusive | shared) >

14.14 locktoken

目的: ロックに関連付けられたロックトークン。

<!ELEMENT locktoken (href) >

14.15 locktype

目的: ロックのアクセスタイプを指定します。現在、書き込みロックのみが定義されています。

<!ELEMENT locktype (write) >

14.16 multistatus

目的: 複数の応答メッセージを含みます。

<!ELEMENT multistatus (response*, responsedescription?)  >

14.17 owner

目的: ロック作成者に関するクライアント提供情報。デッドプロパティとして扱われます (保持される)。

拡張性: 子要素、混合コンテンツ、テキスト、または属性で拡張できます (MAY)。

<!ELEMENT owner ANY >

14.18 prop

目的: リソースプロパティの汎用コンテナ。テキストや混合コンテンツを含んではなりません (MUST NOT)。

<!ELEMENT prop ANY >

14.19 propertyupdate

目的: プロパティ変更リクエストのコンテナ。

<!ELEMENT propertyupdate (remove | set)+ >

14.20 propfind

目的: PROPFINDメソッドから返されるプロパティを指定します。

<!ELEMENT propfind ( propname | (allprop, include?) | prop ) >

14.21 propname

目的: プロパティ名のみを返すことを指定します。

<!ELEMENT propname EMPTY >

14.22 propstat

目的: 特定のhrefに対するpropとstatusをグループ化します。

<!ELEMENT propstat (prop, status, error?, responsedescription?) >

14.23 remove

目的: 削除するプロパティをリストします。プロパティ要素は空でなければなりません (MUST)。

<!ELEMENT remove (prop) >

14.24 response

目的: リソースおよび/またはプロパティに対するメソッドの効果を記述する単一の応答。

<!ELEMENT response (href, ((href*, status)|(propstat+)), error?, responsedescription?, location?) >

14.25 responsedescription

目的: ステータス応答に関する人間が読める情報。

<!ELEMENT responsedescription (#PCDATA) >

14.26 set

目的: 設定するプロパティ値をリストします。プロパティが存在する場合、値は置き換えられます。

<!ELEMENT set (prop) >

14.27 shared

目的: 共有ロックを指定します。

<!ELEMENT shared EMPTY >

14.28 status

目的: 単一のHTTPステータスラインを保持します。

: status-line (RFC 2616のセクション6.1)

<!ELEMENT status (#PCDATA) >

14.29 timeout

目的: ロックの有効期限が切れるまでの残り秒数。

: TimeType (セクション10.7)

<!ELEMENT timeout (#PCDATA) >

14.30 write

目的: 書き込みロックを指定します。

<!ELEMENT write EMPTY >

XML要素カテゴリ

ロック関連要素

activelock, exclusive, shared, lockentry, lockinfo, lockroot, lockscope, locktoken, locktype, timeout, write, owner

プロパティ関連要素

prop, propfind, propname, allprop, include, propertyupdate, propstat, set, remove

レスポンス要素

multistatus, response, propstat, status, error, responsedescription, location

一般要素

href, depth, collection


注記: すべての要素はDAV:名前空間にあります。拡張性ルールを含む完全な仕様については、RFC 4918のセクション14を参照してください。