Changes

If a RESTXQ URL is requested, the [[Options#RESTXQPATH{{Option|RESTXQPATH]] }} module directory and its sub-directories will be traversed, and all [[XQuery Extensions#Suffixes|XQuery files]] will be parsed for functions with RESTXQ annotations. Sub-directories that include an {{Code|.ignore}} file will be skipped.

To speed up processing, the functions of parsed the existing XQuery modules will are automatically be cached in main memory. A cached module :* Functions will be invalidated and parsed again if its the timestamp of their module changes. The timestamp check * File monitoring can be disabled by enabling adjusted via the [[Options#CACHERESTXQ{{Option|CACHERESTXQ]] PARSERESTXQ}} option. This is recommedable for In productive environments with a high load, it may be recommendable to change the timeout, or completely disable monitoring. * If files are all the same replaced while the web server is running, the RESTXQ module cache must should be explicitly invalidated by calling the static root path {{Code|/.init}} or by calling the [[RESTXQ Module#rest:init|rest:init]] function.

* '''HTTP Content Types''': a A function will only be invoked if the HTTP {{Code|Content-Type}} header of the request matches one of the given mime content types. Example:

* '''HTTP Accept''': a A function will only be invoked if the HTTP {{Code|Accept}} header of the request matches one of the defined mime content types. Example:

By default, both mime content types are {{Code|*/*}}. Quality factors supplied by a client will also be considered in the path selection process.If a client supplies the following accept header…

…and if two RESTXQ functions exist with the same {{Code|path}} annotation and , one with the {{Code|produces}} annotations annotation <code>*/*</code> , and another with <code>text/html</code>, respectively, the second function with the second annotation will be called, because the quality factor for <code>text/html</code> documents is higher than highest. With {{Version|9.0}}, support for server-side quality factors was added. If multiple function candidates are left over after the above steps, the one for arbitrary other mime types<code>qs</code> parameter will be considered. The function with the highest quality factor will be favored: <pre class="brush:xquery">%rest:produces("text/html;qs=1")%rest:produces("*/*;qs=0.8")</pre>

Note that this the annotation will ''not'' affect the content-type of the HTTP actual response. Instead, you You will need to add a supply an additional <code>[[#Output|%output:media-type]]</code> annotation.

With the <code>%rest:single</code> annotation, it can be enforced that only one instance of a function will be executed for the same client. If the same function will be called for the second time, the already running query will be stopped, and the HTTP error code {{Code|410460}} (Gone) will be returned instead:

(: If fast enough, returns the result. Otherwise, if called again, raises 410 460 :)

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>410460</code>, and the second one will return <xml>stopped</xml>.

<http:response status="404" messagereason="I was not found.">

Currently, the following external resources on RESTXQ existDocumentation:

External examplesExamples: * Sample code combining XQuery and JavaScript: [https://sharepoint.mathworks.com/dev/doc/kb/_layouts/15/WopiFrame2.aspx?sourcedoc=%7bd3016bb5-9ec5-4289-ba13-0b35636982b1%7dhttphttp://balisage.net/Proceedings/vol17/author-pkg/Galtman01/BalisageVol17-Galtman01.html Materials] and [http://balisage.net/Proceedings/vol17/html/Galtman01/BalisageVol17-Galtman01.html paper] from Amanda Galtman, Balisage 2016.* [[DBA]]: The Database Administration interface, bundled with the full distributions of BaseX.