Main Page » XQuery » Functions » RESTXQ Functions

RESTXQ Functions

This module contains helper functions for the RESTXQ API, some of which are defined in the RESTXQ Draft.

Further RESTXQ related functionality can be found among the Web Functions.

Conventions

  • The module will be available if the basex-api library is found in the classpath. This is the case if you use one of the complete distributions of BaseX (zip, exe, war).
  • All functions are assigned to the http://exquery.org/ns/restxq namespace, which is statically bound to the rest prefix.
  • The http://wadl.dev.java.net/2009/02 namespace is bound to the wadl prefix.
  • If any of the functions is called outside the servlet context, basex:http is raised.

General Functions

rest:base-uri

Signature
rest:base-uri() as xs:anyURI
SummaryReturns the implementation-defined base URI of the resource function.

rest:uri

Signature
rest:uri() as xs:anyURI
SummaryReturns the complete URI that addresses the Resource Function. This is the result of rest:base-uri appended with the path from the path annotation of the resource function.

rest:wadl

Signature
rest:wadl() as element(wadl:application)
SummaryReturns a WADL description of all available REST services.

rest:init

Signature
rest:init(
  $update  as xs:boolean?  := false()
) as empty-sequence()
SummaryInitializes the RESTXQ module cache:
  • By default, the cache will be discarded, and all modules will be parsed and cached again.
  • If $update is enabled, only modules with an updated timestamps will be parsed (see PARSERESTXQ). Rebuilding the cache is usually pretty fast, so this option is rarely required.
  • This function should be called if RESTXQ code is changed at runtime, for example as a result of a hot deploy.

Changelog

Version 9.4Version 8.6Version 7.7
  • Added: New module added.

⚡Generated with XQuery