Changes

BaseX offers access to the databases and documents using This page presents one of the [http://en.wikipedia.org/wiki/Webdav WebDAV[Web Application]] protocolservices. WebDAV provides convenient means It describes how to access and edit XML documents by representing BaseX databases and documents in use the form of a WebDAV file system hierarchyinterface.

==Starting WebDAV==The WebDAV implementation of BaseX is provided by a module (servlet) which runs in offers access to the BaseX HTTP server. Please check databases and documents using the [[Startup#BaseX HTTP Server|Startuphttps: HTTP Server//en.wikipedia.org/wiki/Webdav WebDAV]] page for details on how to start the HTTP Serverprotocol. The WebDAV service can use either the local databases or connect provides convenient means to a remote access and edit XML documents by representing BaseX Server, as described databases and documents in the [[Startup_Options#BaseX_HTTP_Server|startup options]] pageform of a file system hierarchy.

==Authorization==The By default, the BaseX HTTP server makes the WebDAV Server uses the database user service accessible at {{Code|http://localhost:8080/webdav/}}. If no default credentials in order to perform authentication and authorisation. However, if database user and password are explicitly specified when starting , they will be requested by the BaseX HTTP Server using the corresponding client ([[Startup_OptionsWeb Application#BaseX_HTTP_ServerUser Management|startup optionssee further]]). It can be accessed by either <code>http:&#47;&#47;<httphost>:<httpport>/webdav/</code> or <code>webdav://<httphost>:<httpport>/webdav/</code>, then the depending on your WebDAV Server will not request user authentication from the client.

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

=Authentication==Oxygen===* Choose <code>File -> Open URL...</code>.<br/>[[File:Webdav-oxygen01.png]]<br/><br/>* Enter the corresponding user name and password (if needed), the URL of the BaseX WebDAV Server, and then click "Browse".<br/>[[File:Oxygen02.png]]

===Windows Explorer===* Open "Map network drive..." by right-clicking on "My Computer" and click on "Connect to a Web site that you can use to store your documents and pictures."<br/>[[File:Webdav-explorer01.png]]<br/><br/>* Click "Next", select "Choose a custom network location" and click "Next" again.<br/>[[File:Webdav-explorer03.png]]<br/><br/>* Enter the URL address of the BaseX The WebDAV Server and click "Next".<br/>[[File:Webdav-explorer04.png]]<br/>If a message saying that service uses the folder is not valid, this is because Microsoft WebClient is not configured to use Baseic HTTP authentication. Please check [http://support.microsoft.com/kb/928692/en this Microsoft article] in order database user credentials to enable Basic HTTP perform authentication.<br/><br/>* Enter a name for the network location and click "Next".<br/>[[File:Webdav-explorer06authorization.png]]<br/><br/>* The BaseX WebDAV A default user can be accessed from defined in the Explorer window.<br/>configuration [[File:Webdav-explorer07.pngWeb Application#Authentication|as described here]]<br/>.

=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= =Linux=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: Konqueror * 160 (non-breaking space)* 8192–8207, Dolphin8232–8239, Nautilus8287–8303 (see [https://en.wikipedia.org/wiki/General_Punctuation General Punctuation]) ==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. =Locking= The BaseX WebDAV implementation supports locking. It can be utilized with clients which support this feature (e.g. [[oXygen|oXygen Editor]]). [https://tools.ietf.org/html/rfc4918#section-6.2 EXCLUSIVE and OthersSHARED] locks are supported, as well as [https://tools.ietf.org/html/rfc4918#section-7 WRITE] locks. '''Note:''' WebDAV locks are stored in a database called <code>~webdav</code>. If the database is deleted, it will automatically be recreated along with the next lock operations. If a resource remains locked, it can be unlocking by removing the correspondent <code><w:lockinfo></code> entry. =WebDAV Clients= Please check out the following tutorials to get WebDAV running on different operating systems and with oXygen: * [[WebDAV: Windows 7|Windows 7 and up]]* [[WebDAV: Windows XP|Windows XP]]* [[WebDAV: Mac OSX|Mac OSX 10.4+]]* [[WebDAV: GNOME|GNOME and Nautilus]]* [[WebDAV: KDE|KDE]]* [[Integrating oXygen|oXygen Editor]] =Changelog= ;Version 7.7* Added: [[#Locking|Locking]] ;Version 7.0* WebDAV API introduced