Changes

:<code>http://localhost:8984/rest</code>

<rest:databases resources="1" xmlns:rest="http://basex.org/rest">

<rest:database resources="1" size="1813599">factbook</rest:database>

</rest:databases>

The resources of a database can be listed by specifying the database, and potential sub directories, in the URL.

:<code>http://localhost:8984/rest/factbook</code>

<rest:database name="factbook" resources="1" xmlns:rest="http://basex.org/rest">

<rest:resource type="xml" content-type="application/xml" size="77192">factbook.xml</rest:resource>

</rest:database>

The contents of a database can be retrieved by directly addressing the resource:

* Create an empty database and return database information:

<commands>

<create-db name='db'/>

<info-db/>

</commands>

For the other commands, the following child elements are supported:

* Return the first five city names of the <b>factbook</b> database:

<rest:query xmlns:rest="http://basex.org/rest">

<rest:text><![CDATA[ (//city/name)[position() <= 5] ]]></rest:text>

</rest:query>

* Return string lengths of all text nodes that are found in the node that has been specified as initial context node:

<query>

<text>for $i in .//text() return string-length($i)</text>

</context>

</query>

* Return the registered database users encoded in <code>ISO-8859-1</code>:

<command>

<text>show users</text>

<parameter name='encoding' value='ISO-8859-1'/>

</command>

* Create a new database from the specified input and preserve all whitespaces:

<command>

<text>create db test http://files.basex.org/xml/xmark.xml</text>

<option name='chop' value='false'/>

</command>

* Bind value to the {{Code|$person}} variable and run query <code>find-person.xq</code>, which must be located in the directory specified by {{Option|WEBPATH}}:

<run>

<variable name='person' value='Johannes Müller'/>

<text>find-person.xq</text>

</run>

==PUT Method==

* The following request assigns two variables to a server-side query file <code>mult.xq</code> placed in the HTTP directory:<br/><code>http://localhost:8984/rest?run=mult.xq&$a=21&$b=2</code>

(: XQuery file: mult.xq :)

declare variable $a as xs:integer external;

declare variable $b as xs:integer external;

<mult>{ $a * $b }</mult>

The dollar sign can be omitted as long as the variable name does not equal a parameter keyword (e.g.: <code>method</code>).

If <code>query</code> or <code>run</code> is used as operation, external variables can be specified via the <code><variable/></code> element:

<query xmlns="http://basex.org/rest">

<text><![CDATA[

<variable name="b" value="2"/>

</query>

=Response=

<code>org.basex.util.Base64</code> can be used for that purpose:

import java.net.*;

import org.basex.util.*;

}

}

===Content-Types===

the connection (in this example we explicitly store the input file as raw):

// store input as raw

conn.setRequestProperty("Content-Type", "application/octet-stream");

See the [[REST#PUT Requests|PUT Requests]] section for a description of the possible content-types.