WebDAV

From BaseX Documentation
Revision as of 15:42, 12 September 2011 by Dimitar (talk | contribs) (→‎Windows Explorer: Added screen shots for Windows Explorer)
Jump to navigation Jump to search

BaseX offers access to the databases and documents using the 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.

Starting BaseX WebDAV

The WebDAV implementation of BaseX is provided by a module (servlet) which runs in the BaseX HTTP server. Please, check the Startup: BaseX HTTP Server page for details on how to start the BaseX HTTP Server. The BaseX WebDAV Server can use either the local databases or connect to a remote BaseX Server. Please, check the startup options of the BaseX HTTP Server.

Accessing BaseX WebDAV

The BaseX WebDAV Server can be accessed using either with a http://<httphost>:<httpport>/webdav/ or webdav://<httphost>:<httpport>/webdav/ URL, depending on the used WebDAV client. For example, http://localhost:8984/webdav/.

Authorisation

The BaseX WebDAV Server uses the database user credentials in order to perform authentication and authorisation. However, if database user and password are explicitly specified when starting the BaseX HTTP Server using the corresponding startup options, then the WebDAV Server will not request user authentication from the client.

WebDAV Clients

Oxygen

  • Choose File -> Open URL....

File:Webdav-oxygen01.png

  • Enter the corresponding user name and password (if needed), the URL of the BaseX WebDAV Server, and then click "Browse".

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."

Webdav-explorer01.png

  • Click "Next", select "Choose a custom network location" and click "Next" again.

Webdav-explorer03.png

  • Enter the URL address of the BaseX WebDAV Server and click "Next".

Webdav-explorer04.png
If a message saying that the folder is not valid, this is because Microsoft WebClient is not configured to use Baseic HTTP authentication. Please check this Microsoft article in order to enable Basic HTTP authentication.

  • Enter a name for the network location and click "Next".

Webdav-explorer06.png

  • The BaseX WebDAV can be accessed from the Explorer window.

Webdav-explorer07.png

Linux: Konqueror, Dolphin, Nautilus, and Others