Changes

</response>

};

If the URI http://localhost:8080/hello/World is accessed, the result will be:

<title>Hello World!</title>

</response>

The next function demonstrates a POST request:

</response>

};

If you post something (e.g. using curl or the embedded form at http://localhost:8080/)...

<syntaxhighlight lang="shell">

curl -i -X POST --data "message='CONTENT'" http://localhost:8080/form

...you will receive something similar to the following result:

Content-Length: 107

Server: Jetty(8.1.11.v20130520)

<syntaxhighlight lang="xml">

<user-agent>curl/7.31.0</user-agent>

</response>

=Request=

declare %rest:path("/a/path/{$with}/some/{$variable}")

function page:test($with, $variable as xs:integer) { ... };

<!-- TODO how matching works -->

declare %rest:path("app/{$path=.+}")

function page:others($path) { ... };

<!-- TODO how matching works -->

%rest:consumes("text/xml")

function page:xml($body) { $body };

====Producing Data====

%rest:produces("application/xml", "text/xml")

function page:xml() { <xml/> };

Note that the annotations will ''not'' affect the type of the actual response: You will need to supply an additional <code>[[#Output|%output:media-type]]</code> annotation or (if a single function may produce results of different types) generate an apt [[#Custom_Response|Custom Response]].

...

declare function %rest:produces("*/*") ...

…the first of these function will be chosen, as the quality factor for <code>text/html</code> documents is highest.

...

declare function %rest:produces("*/*;qs=0.5") ...

===HTTP Methods===

declare %rest:GET %rest:POST %rest:path("/post")

function page:post() { "This was a GET or POST request" };

The POST and PUT annotations may optionally take a string literal in order to map the HTTP request body to a [[#Parameters|function argument]]. Once again, the target variable must be embraced by curly brackets:

declare %rest:PUT("{$body}") %rest:path("/put")

function page:put($body) { "Request body: " || $body };

====Custom Methods====

"Size of body: " || bin:length($body)

};

If an OPTIONS request is received, and if no function is defined, an automatic response will be generated, which includes an <code>Allow</code> header with all supported methods.

"Number of rows: " || count($csv/csv/record)

};

===Multipart Types===

"Number of items: " || count($data)

};

==Parameters==

<result id="{ $id }" sum="{ sum($add) }"/>

};

===HTML Form Fields===

<pre lang='xquery'>

%rest:form-param("city", "{$city}", "no-city-specified")

The values are the result of HTML forms submitted with the (default) content type <code>application/x-www-form-urlencoded</code>:

<input type="submit"/>

</form>

====File Uploads====

<input type="submit"/>

</form>

The file contents are placed in a [[Map Module|map]], with the filename serving as key. The following example shows how uploaded files can be stored in a temporary directory:

)

};

===HTTP Headers===

%rest:header-param("User-Agent", "{$user-agent}")

%rest:header-param("Referer", "{$referer}", "none")

===Cookies===

%rest:cookie-param("username", "{$user}")

%rest:cookie-param("authentication", "{$auth}", "no_auth")

==Query Execution==

}</ul>

};

By adding a string value to with the annotation, functions can be bundled together, and a running query can be canceled by calling another one that has the same annotation value. This is shown by another example, in which the first function can be interrupted by the second one. If you call both functions in separate browser tabs, you will note that the first tab will return <code>460</code>, and the second one will return <xml>stopped</xml>.

<xml>stopped</xml>

};

The following things should be noted:

"The requested resource is not available."

};

For the time being, it is not possible to create multipart responses.

</http:response>

</rest:response>

The convenience function {{Function|Web|web:redirect}} can be called to create such a response.

'Stored documents: ' || count(db:get('app'))

};

===Forwards===

<syntaxhighlight lang="xml">

<rest:forward>new-location</rest:forward>

The response can also be created with the convenience function {{Function|Web|web:forward}}.

'Keep it simple, stupid'

};

===Annotations===

}

};

The next function, when called, generates XHTML headers, and {{Code|text/html}} will be set as content type:

</html>

};

===Response Element===

'Not that simple anymore'

};

=Error Handling=

web:error(418, "I'm a pretty teapot")

};

In contrast to the standard <code>fn:error</code> function, a status code can be supplied, and the response body will only contain the specified error message and no stack trace.

'User "' || $user || '" is unknown'

};

==Catch HTTP Errors==

<location>/error404</location>

</error-page>

The target location may be another RESTXQ function. The {{Function|Request|request:attribute}} function can be used to request details on the caught error:

"Error message: " || request:attribute("javax.servlet.error.message")

};

=User Authentication=

'Remote host name: ' || request:remote-hostname()

};

=References=