eXist Command: invoke
invokes a stored query on an eXist serverSynopsis
invoke [exist options] [options] query-uriDescription
Invokes a stored query residing on an eXist server. In order for a resource to be used with invoke it must be stored with the Content-Type of "application/xquery".Options
The invoke command accepts all eXist Common Options| -d,-data file | Supplies the contents of "file" as the input data to the stored query |
| -raw | Outputs the results without any parsing. Supplying -d assumes -raw |
If -d or -data is specified then the file (or standard input if "-") is supplied to the query. Otherwise no data is supplied to the query.
Example
Assuming the prefix "e" is imported as the exist, invokes the stored procedure "run.xquery"e:invoke run.xquery
For example storing the query "1 to 5,'hi',<elem/>" then invoking it.
echo "1 to 5,'hi',<elem/>" | e:put -uri /db/test/run.xquery -contentType application/xquery e:invoke /db/test/run.xquery
Result
1 2 3 4 5 hi <elem/>
Implementation
invoke is implemented using the REST protocol using the GET and POST methods.
When no -data argument is supplied then GET is used and the result is wrapped by eXist into a structure which is parsed as XDM values (unless -raw is specified).
When a -data argument is supplied then POST is used and the resulting data is returned in the raw as text.
See http://exist.sourceforge.net/devguide_rest.html
eXist Extension Module
