Changes

Jump to navigation Jump to search
1,479 bytes added ,  17:06, 22 November 2017
no edit summary
This article is part of the [[XQuery|XQuery Portal]].It summarizes the codes of errors that are raised by thestandard features and functions of XQuery. As the original specificationsare pretty comprehensive, we tried our best to make this overviewcomprehensible to a wider range of readers.
The following tables list the error codes that are known to BaseX,a short description, and examples of queries raising that errors.Errors that are specific to BaseX can be found in the descriptionsof the respective [[Module Library|modules]].
Original definitions of the error codes are found in the[http://www.w3.org/TR/xquery-30/ XQuery 3.0],[http://www.w3.org/TR/xpath-functions-30/ XQuery 3.0 Functions],[http://www.w3.org/TR/xquery-update-10/ XQuery 1.0 Update],[http://www.w3.org/TR/xpath-full-text-10/ XQuery 1.0 Full Text],and [http://www.expath.org/spec/http-client EXPath HTTP]Specifications.
=Static Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|XPST}}, {{Code|XQST}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>XPST0003</code>
=Type Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|XPTY}}, {{Code|XQTY}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>XPTY0004</code>
=Dynamic Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|XPDY}}, {{Code|XQDY}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>XPDY0002</code>
=Functions Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FOAR}}, {{Code|FOCA}}, {{Code|FOCH}}, {{Code|FODC}}, {{Code|FODF}}, {{Code|FODT}}, {{Code|FOER}}, {{Code|FOFD}}, {{Code|FONS}}, {{Code|FORG}}, {{Code|FORX}}, {{Code|FOTY}}, {{Code|FOUT}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>FOAR0001</code>
=Serialization Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|SEPM}}, {{Code|SERE}}, {{Code|SESU}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>SESU0007</code>
=Update Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FOUP}}, {{Code|XUDY}}, {{Code|XUST}}, {{Code|XUTY}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>FOUP0001</code>
=Full-Text Errors=
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FTDY}}, {{Code|FTST}}
{| class="wikitable" width="100%"
! width="110"|Code
! width="50%" |Description
|!Examples
|- valign="top" scope="row"
|<code>FTDY0016</code>
=BaseX Errors=
Error Codes* Namespace URI: {{Code|BASX}}<code><nowiki>http://basex.org</nowiki></code>* Namespace prefix: <code>basex</code>
{| class="wikitable" width="100%"
! width="110"|Code
! widthDescription!Examples|- valign="50top" scope="row"|<code>annotation</code>| Annotation errors.|<code>%basex:xyz function() { 123 }</code>|- valign=" top" scope="row"|<code>doc</code>| The argument specified via fn:doc must yield a single document.|Description<code>doc('db-collection')</code>|- valign="top" scope="row"|<code>error</code>| Generic error, which is e. g. raised by [[Java Bindings#Integration|Java bindings]].|Examples<code>import module namespace qm='java:org.basex.query.func.QueryModuleTest';<br/>qm:error()</code>
|- valign="top" scope="row"
|<code>permissionfunction</code>| A user lacks permissions to open a database, update nodes, etcFunction items cannot be cached.|<code>db:openoutput('admin'true#0)</code>
|- valign="top" scope="row"
|<code>http</code>
|<code>session:get('abc')</code>
|- valign="top" scope="row"
|<code>BASX0000options</code>| Generic error, which The specified database option is used for exceptions in [[Java Bindings#Integration|Java bindings]]unknown.|<code>declare option db:xyz 'no'; 1</code>
|- valign="top" scope="row"
|<code>BASX0001overflow</code>| The current user has insufficient [[User Management|permissions]] to execute an expressionStack overflow.|<code>filedeclare function local:a() { local:b() + 1 };<br/>declare function local:b() { local:a() + 2 };<br/>local:deletea('file.txt')</code>: ''Create'' rights needed.
|- valign="top" scope="row"
|<code>BASX0002permission</code>| The specified current user has insufficient [[User Management|permissions]] to open a database option is unknown, update nodes, etc.|<code>declare option db:xyz "no"; 1open('admin')</code>
|- valign="top" scope="row"
|<code>BASX0003restxq</code>
| Errors related to [[RESTXQ]].
|<code>%restxq:GET('x')</code>
|- valign="top" scope="row"
|<code>update</code>
| BaseX-specific update errors.
|<code><a/> update db:output('bla')</code>
|}
Additional, module-specific error codes are listed in the descriptions of the query modules.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu