Difference between revisions of "WebDAV"

From BaseX Documentation
Jump to navigation Jump to search
Line 3: Line 3:
 
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.
 
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.
  
==Starting WebDAV==
+
==Getting Started==
  
 
First of all, launch the BaseX as [[Web Application]]. By default, [http://jetty.codehaus.org/jetty/ Jetty] is used as web server. All HTTP services will be available on port <code>8984</code>, and the WebDAV service is accessible at {{Mono|http://localhost:8984/webdav/}}.
 
First of all, launch the BaseX as [[Web Application]]. By default, [http://jetty.codehaus.org/jetty/ Jetty] is used as web server. All HTTP services will be available on port <code>8984</code>, and the WebDAV service is accessible at {{Mono|http://localhost:8984/webdav/}}.
Line 9: Line 9:
 
If the server is started as Servlet, all [[Options#Main Options|Main Options]] (such as the path to the database) can be configured in the {{Mono|web.xml}} file. If run as a standalone application, the settings are stored in the file {{Mono|.basex}}.
 
If the server is started as Servlet, all [[Options#Main Options|Main Options]] (such as the path to the database) can be configured in the {{Mono|web.xml}} file. If run as a standalone application, the settings are stored in the file {{Mono|.basex}}.
  
==Accessing WebDAV==
+
Generally, the BaseX WebDAV Server can be accessed using either with a <code>http:&#47;&#47;<httphost>:<httpport>/webdav/</code> or <code>webdav://<httphost>:<httpport>/webdav/</code> URL, depending on the used WebDAV client.
 
 
The BaseX WebDAV Server can be accessed using either with a <code>http:&#47;&#47;<httphost>:<httpport>/webdav/</code> or <code>webdav://<httphost>:<httpport>/webdav/</code> URL, depending on the used WebDAV client. By default, after
 
starting the HTTP server, the following URL will be provided: <code>http://localhost:8984/webdav/</code>.
 
  
 
==Authorization==
 
==Authorization==

Revision as of 17:11, 24 March 2012

This page is part of the Developer Section. It describes how to use the WebDAV file system interface.

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.

Getting Started

First of all, launch the BaseX as Web Application. By default, Jetty is used as web server. All HTTP services will be available on port 8984, and the WebDAV service is accessible at http://localhost:8984/webdav/.

If the server is started as Servlet, all Main Options (such as the path to the database) can be configured in the web.xml file. If run as a standalone application, the settings are stored in the file .basex.

Generally, 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.

Authorization

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 options, WebDAV will not request additional user authentication from the client.

WebDAV Clients

Please check out the following tutorials to get WebDAV running on different operating systems and with oXygen:

Changelog

Version 7.0

  • WebDAV API introduced