Difference between revisions of "WebDAV"

From BaseX Documentation
Jump to navigation Jump to search
Line 18: Line 18:
 
==WebDAV Clients==
 
==WebDAV Clients==
  
Some tutorials are available to get WebDAV running with different tools and operating systems:
+
Please check out the following tutorials to get WebDAV running on different operating systems and with oXygen:
  
 
* [[WebDAV/Windows 7|Windows 7]]
 
* [[WebDAV/Windows 7|Windows 7]]
Line 26: Line 26:
 
* [[WebDAV/KDE|KDE]]
 
* [[WebDAV/KDE|KDE]]
 
* [[Integrating oXygen|oXygen Editor]]
 
* [[Integrating oXygen|oXygen Editor]]
 
===GNOME Nautilus===
 
* In Nautilus choose File -> Connect to Server:
 
[[File:webdav-nautilus01.png]]<br/>
 
* Choose "WebDAV (HTTP)" from the "Type" drop-down and enter the server address, port and user credentials:
 
[[File:webdav-nautilus02.png]]<br/>
 
* After clicking "Connect" the databases can be browsed:
 
[[File:webdav-nautilus03.png]]<br/>
 
 
===KDE===
 
 
* KDE SC provides two file managers - Dolphin and Konqueror, which both support WebDAV using the "webdav://" URL prefix. Start Dolphin or Konqueror and enter the BaseX WebDAV URL (eg. webdav://localhost:8984/webdav):
 
[[File:webdav-dolphin01.png]]<br/>
 
* Enter the user credentials:
 
[[File:webdav-dolphin02.png]]<br/>
 
* After clicking "OK" the databases can be browsed:
 
[[File:webdav-dolphin03.png]]<br/>
 
 
===Mac OS X 10.4+===
 
 
* Mac OS X supports WebDAV since 10.4/Tiger
 
* Open Finder, choose Go -> Connect to Server:
 
[[File:Webdav-osx-1.jpg]]
 
* Enter BaseX WebDAV URL (eg. http://localhost:8984/webdav) - do not use webdav://-scheme! Press Connect:
 
[[File:Webdav-osx-2.jpg]]
 
* Enter the user credentials:
 
[[File:Webdav-osx-3.jpg]]
 
* That's it, now the databases can be browsed:
 
[[File:Webdav-osx-4.jpg]]
 
 
===oXygen Editor===
 
 
Please have a look at our tutorial [[Integrating oXygen|How to integrate oXygen]] in BaseX.
 
 
===Windows 7===
 
* Open "Map network drive..." by right-clicking on "My Computer"
 
* Click on the link "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 WebDAV Server (e.g. <code>http://localhost:8984/webdav</code>) and click "Next".<br/>
 
[[File:Webdav-explorer04.png]]<br/>
 
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 [http://support.microsoft.com/kb/928692/en this Microsoft article] in order to enable Basic HTTP authentication.<br/><br/>
 
* Enter a name for the network location and click "Next".<br/>
 
[[File:Webdav-explorer06.png]]<br/><br/>
 
* The BaseX WebDAV can be accessed from the Explorer window.<br/>
 
[[File:Webdav-explorer07.png]]<br/>
 
 
===Windows XP===
 
 
* In the "My Network Places" view, double click on "Add Network Place":
 
[[File:WinXP01.png]]<br/>
 
* Confirm the upcoming introductory dialog:
 
[[File:WinXP02.png]]<br/>
 
* Select "Choose another network location" in the next dialog:
 
[[File:WinXP03.png]]<br/>
 
* Next, specify the BaseX WebDAV URL:
 
[[File:WinXP04.png]]<br/>
 
* Enter the user/password combination to connect to the WebDAV service:
 
[[File:WinXP05.png]]<br/>
 
* Assign a name to your WebDAV connection:
 
[[File:WinXP06.png]]<br/>
 
* Finish the wizard:
 
[[File:WinXP07.png]]<br/>
 
* You can now see all BaseX databases in the Windows Explorer:
 
[[File:WinXP08.png]]<br/>
 

Revision as of 00:14, 10 December 2011

This page is part of the Developer Section. It describes how to use the WebDAV API of BaseX.

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 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 HTTP Server. The WebDAV service can either use the local databases or connect to a remote BaseX Server, as described in the startup options page.

Accessing 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. By default, after starting the HTTP server, the following URL will be provided: http://localhost:8984/webdav/.

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: