Changes

BaseX offers access to the databases and documents using the [http://en.wikipedia.org/wiki/Webdav WebDAV] protocol. WebDAV provides convenient means to access and edit XML documents by representing BaseX databases and documents in the form of a file system hierarchy.  The implementation in BaseX is based on the [http://milton.io Milton library]. Currently, only Basic Authentication is supported.

By default, the BaseX HTTP server makes the WebDAV service is activated and is accessible at {{Code|http://localhost:8984/webdav/}}. Generally it If no default credentials are specified, they will be requested by the client ([[Web Application#User Management|see further]]). It can be accessed using by either with a <code>http:&#47;&#47;<httphost>:<httpport>/webdav/</code> or <code>webdav://<httphost>:<httpport>/webdav/</code> URL, depending on the used your WebDAV client.

Please note that the file size of XML documents will be displayed as 0 bytes, as the actual file size cannot can only be determined until if the full document is being returned and serialized. This may cause problems with some WebDAV clients (e.g. NetDrive or WebDrive).

The WebDAV service uses the database user credentials in order to perform authentication and authorization. If database user and password are explicitly specified when starting the BaseX HTTP Server using the corresponding [[Startup_OptionsCommand-Line Options#BaseX_HTTP_Server|startup options]], WebDAV will not request additional user authentication from the client. =Root Directory= In the WebDAV root directory, all existing databases are listed. As new resources can only be stored inside a database, it is not possible to store files in the root directory. If a file is copied on top level, a new database will be created, which contains this resource. =Resources= ==XML Documents== Uploaded files that start with an angle bracket will be stored as XML files. XML entities will be decoded during this process. If a file is downloaded, the characters with the following code points will be encoded as entities: * 160 (non-breaking space)* 8192–8207, 8232–8239, 8287–8303 (see http://www.w3schools.com/charsets/ref_utf_punctuation.asp) ==Binary Files== If XML parsing files, or if the first character of the input is no angle bracket, the file will be stored as binary resource.

The BaseX WebDAV implementation supports WebDAV locking since {{Version|7.7}}. It can be utilized with clients which support this feature (e.g. [[oXygen|oXygen Editor]]). [http://tools.ietf.org/html/rfc4918#section-6.2 EXCLUSIVE and SHARED] locks are supported, as well as [http://tools.ietf.org/html/rfc4918#section-7 WRITE] locks.

'''Note:''' WebDAV locks are stored in a database called <code>~webdav</code>. Implementations should not rely on If the existence of database is deleted, it will automatically be recreated along with the databasenext lock operations. If a resource remains locked, since it may not can be accessible in unlocking by removing the futurecorrespondent <code><w:lockinfo></code> entry.

* [[WebDAV: Windows 7|Windows 7and up]]

* Added: [[#Locking|Locking]]