Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol
RFC 3648
Document | Type | RFC - Proposed Standard (December 2003; No errata) | |
---|---|---|---|
Authors | Jim Whitehead , Julian Reschke | ||
Last updated | 2015-10-14 | ||
Stream | IETF | ||
Formats | plain text html pdf htmlized bibtex | ||
Stream | WG state | (None) | |
Document shepherd | No shepherd assigned | ||
IESG | IESG state | RFC 3648 (Proposed Standard) | |
Action Holders |
(None)
|
||
Consensus Boilerplate | Unknown | ||
Telechat date | |||
Responsible AD | Ted Hardie | ||
IESG note | Text added to clear Allison's issue with ordering semantics | ||
Send notices to | <lisa@xythos.com> |
Network Working Group J. Whitehead Request for Comments: 3648 U.C. Santa Cruz Category: Standards Track J. Reschke, Ed. greenbytes December 2003 Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Copyright Notice Copyright (C) The Internet Society (2003). All Rights Reserved. Abstract This specification extends the Web Distributed Authoring and Versioning (WebDAV) Protocol to support the server-side ordering of collection members. Of particular interest are orderings that are not based on property values, and so cannot be achieved using a search protocol's ordering option and cannot be maintained automatically by the server. Protocol elements are defined to let clients specify the position in the ordering of each collection member, as well as the semantics governing the ordering. Whitehead & Reschke Standards Track [Page 1] RFC 3648 WebDAV Ordered Collections Protocol December 2003 Table of Contents 1. Notational Conventions . . . . . . . . . . . . . . . . . . . . 3 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Overview of Ordered Collections . . . . . . . . . . . . . . . 5 4.1. Additional Collection properties . . . . . . . . . . . . 6 4.1.1. DAV:ordering-type (protected). . . . . . . . . . 6 5. Creating an Ordered Collection . . . . . . . . . . . . . . . . 7 5.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . 7 5.2. Example: Creating an Ordered Collection. . . . . . . . . 8 6. Setting the Position of a Collection Member. . . . . . . . . . 8 6.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . 8 6.2. Examples: Setting the Position of a Collection Member. . 10 6.3. Examples: Renaming a member of an ordered collection . . 10 7. Changing a Collection Ordering: ORDERPATCH method. . . . . . . 11 7.1. Example: Changing a Collection Ordering. . . . . . . . . 13 7.2. Example: Failure of an ORDERPATCH Request. . . . . . . . 14 8. Listing the Members of an Ordered Collection . . . . . . . . . 16 8.1. Example: PROPFIND on an Ordered Collection . . . . . . . 17 9. Relationship to versioned collections. . . . . . . . . . . . . 19 9.1. Collection Version Properties. . . . . . . . . . . . . . 20 9.1.1. Additional semantics for DAV:version-controlled-binding-set (protected) . 20 9.1.2. DAV:ordering-type (protected). . . . . . . . . . 20 9.2. Additional CHECKIN semantics . . . . . . . . . . . . . . 20 9.3. Additional CHECKOUT Semantics. . . . . . . . . . . . . . 20 9.4. Additional UNCHECKOUT, UPDATE, and MERGE Semantics . . . 21 10. Capability Discovery . . . . . . . . . . . . . . . . . . . . . 21 10.1. Example: Using OPTIONS for the Discovery of Support for Ordering . . . . . . . . . . . . . . . . . . . . . . . . 22 10.2. Example: Using Live Properties for the Discovery of Ordering . . . . . . . . . . . . . . . . . . . . . . . . 22 11. Security Considerations. . . . . . . . . . . . . . . . . . . . 23 11.1. Denial of Service and DAV:ordering-type . . . . . . . . 23 12. Internationalization Considerations. . . . . . . . . . . . . . 24 13. IANA Considerations. . . . . . . . . . . . . . . . . . . . . . 24 14. Intellectual Property Statement. . . . . . . . . . . . . . . . 25 15. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 25 16. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 25 17. Normative References . . . . . . . . . . . . . . . . . . . . . 26 A. Extensions to the WebDAV Document Type Definition. . . . . . . 27 Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 29 Full Copyright Statement . . . . . . . . . . . . . . . . . . . . . 30 Whitehead & Reschke Standards Track [Page 2] RFC 3648 WebDAV Ordered Collections Protocol December 2003 1. Notational Conventions Since this document describes a set of extensions to the WebDAVShow full document text