Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol
RFC 3648

Document Type RFC - Proposed Standard (December 2003; No errata)
Last updated 2015-10-14
Stream IETF
Formats plain text pdf html bibtex
Stream WG state (None)
Document shepherd No shepherd assigned
IESG IESG state RFC 3648 (Proposed Standard)
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]
Show full document text