Web Distributed Authoring and Versioning (WebDAV) SEARCH
RFC 5323
Document | Type |
RFC - Proposed Standard
(November 2008; No errata)
Was draft-reschke-webdav-search (individual in app area)
|
|
---|---|---|---|
Authors | Jim Davis , Alan Babich , Surendra Reddy , Julian Reschke | ||
Last updated | 2015-10-14 | ||
Stream | IETF | ||
Formats | plain text html pdf htmlized bibtex | ||
Reviews | |||
Stream | WG state | (None) | |
Document shepherd | No shepherd assigned | ||
IESG | IESG state | RFC 5323 (Proposed Standard) | |
Consensus Boilerplate | Unknown | ||
Telechat date | |||
Responsible AD | Chris Newman | ||
Send notices to | (None) |
Network Working Group J. Reschke, Ed. Request for Comments: 5323 greenbytes Category: Standards Track S. Reddy Mitrix J. Davis A. Babich IBM November 2008 Web Distributed Authoring and Versioning (WebDAV) SEARCH 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) 2008 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Abstract This document specifies a set of methods, headers, and properties composing Web Distributed Authoring and Versioning (WebDAV) SEARCH, an application of the HTTP/1.1 protocol to efficiently search for DAV resources based upon a set of client-supplied criteria. Reschke, et al. Standards Track [Page 1] RFC 5323 WebDAV SEARCH November 2008 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.1. DASL . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2. Relationship to DAV . . . . . . . . . . . . . . . . . . . 4 1.3. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.4. Notational Conventions . . . . . . . . . . . . . . . . . . 6 1.5. Note on Usage of 'DAV:' XML Namespace . . . . . . . . . . 7 1.6. An Overview of DASL at Work . . . . . . . . . . . . . . . 7 2. The SEARCH Method . . . . . . . . . . . . . . . . . . . . . . 7 2.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.2. The Request . . . . . . . . . . . . . . . . . . . . . . . 8 2.2.1. The Request-URI . . . . . . . . . . . . . . . . . . . 8 2.2.2. The Request Body . . . . . . . . . . . . . . . . . . . 8 2.3. The Successful 207 (Multistatus) Response . . . . . . . . 9 2.3.1. Result Set Truncation . . . . . . . . . . . . . . . . 9 2.3.2. Extending the PROPFIND Response . . . . . . . . . . . 10 2.3.3. Example: A Simple Request and Response . . . . . . . . 10 2.3.4. Example: Result Set Truncation . . . . . . . . . . . . 11 2.4. Unsuccessful Responses . . . . . . . . . . . . . . . . . . 12 2.4.1. Example of an Invalid Scope . . . . . . . . . . . . . 12 3. Discovery of Supported Query Grammars . . . . . . . . . . . . 13 3.1. The OPTIONS Method . . . . . . . . . . . . . . . . . . . . 13 3.2. The DASL Response Header . . . . . . . . . . . . . . . . . 14 3.3. DAV:supported-query-grammar-set (Protected) . . . . . . . 14 3.4. Example: Grammar Discovery . . . . . . . . . . . . . . . . 15 4. Query Schema Discovery: QSD . . . . . . . . . . . . . . . . . 17 4.1. Additional SEARCH Semantics . . . . . . . . . . . . . . . 17 4.1.1. Example of Query Schema Discovery . . . . . . . . . . 18 5. The DAV:basicsearch Grammar . . . . . . . . . . . . . . . . . 19 5.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . 19 5.2. The DAV:basicsearch DTD . . . . . . . . . . . . . . . . . 20 5.2.1. Example Query . . . . . . . . . . . . . . . . . . . . 22 5.3. DAV:select . . . . . . . . . . . . . . . . . . . . . . . . 23 5.4. DAV:from . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.4.1. Relationship to the Request-URI . . . . . . . . . . . 23 5.4.2. Scope . . . . . . . . . . . . . . . . . . . . . . . . 24 5.5. DAV:where . . . . . . . . . . . . . . . . . . . . . . . . 24 5.5.1. Use of Three-Valued Logic in Queries . . . . . . . . . 24 5.5.2. Handling Optional Operators . . . . . . . . . . . . . 24 5.5.3. Treatment of NULL Values . . . . . . . . . . . . . . . 24 5.5.4. Treatment of Properties with Mixed/Element Content . . 25 5.5.5. Example: Testing for Equality . . . . . . . . . . . . 25 5.5.6. Example: Relative Comparisons . . . . . . . . . . . . 25Show full document text