<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage--> <HTML> <HEAD> <!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:46 GMT 2011 --> <TITLE> XQQueryException </TITLE> <META NAME="date" CONTENT="2011-12-09"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { parent.document.title="XQQueryException"; } } </SCRIPT> <NOSCRIPT> </NOSCRIPT> </HEAD> <BODY BGCOLOR="white" onload="windowTitle();"> <HR> <!-- ========= START OF TOP NAVBAR ======= --> <A NAME="navbar_top"><!-- --></A> <A HREF="#skip-navbar_top" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_top_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../javax/xml/xquery/XQPreparedExpression.html" title="interface in javax.xml.xquery"><B>PREV CLASS</B></A> <A HREF="../../../javax/xml/xquery/XQResultItem.html" title="interface in javax.xml.xquery"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?javax/xml/xquery/XQQueryException.html" target="_top"><B>FRAMES</B></A> <A HREF="XQQueryException.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <!-- ======== START OF CLASS DATA ======== --> <H2> <FONT SIZE="-1"> javax.xml.xquery</FONT> <BR> Class XQQueryException</H2> <PRE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">java.lang.Throwable</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">java.lang.Exception</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">javax.xml.xquery.XQException</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>javax.xml.xquery.XQQueryException</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://download.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</A></DD> </DL> <DL> <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../javax/xml/xquery/XQCancelledException.html" title="class in javax.xml.xquery">XQCancelledException</A></DD> </DL> <HR> <DL> <DT><PRE>public class <B>XQQueryException</B><DT>extends <A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></DL> </PRE> <P> An exception that provides information on errors occurring during the evaluation of an xquery. <br> <br> Each <code>XQQueryException</code> provides several kinds of optional information, in addition to the properties inherited from <code>XQException</code>: <ul> <li>an error code. This <code>QName</code> identifies the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"><i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"><i> Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and and its associated specifications; implementation-defined errors may be raised.</li> <li>a position. This identifies the character position of the failing expression in the query text. This is a <code>0</code> based position. <code>-1</code> if unknown.</li> <li>the line number in the query string where the error occured. Line numbering starts at <code>1</code>. <code>-1</code> if unknown</li> <li>the column number in the query string where the error occured. Column numbering starts at <code>1</code>. <code>-1</code> if unknown</li> <li>the module uri. This identifies the module in which the error occurred, <code>null</code> when the error is located in the main module.</li> <li>the XQuery error object of this exception. This is the <code>$error-object</code> argument specified through the <code>fn:error()</code> function. May be <code>null</code> if not specified. </li> <li>the XQuery stack trace. This provides additional dynamic information where the exception occurred in the XQuery expression.</li> <P> <P> <DL> <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html#javax.xml.xquery.XQQueryException">Serialized Form</A></DL> <HR> <P> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#XQQueryException(java.lang.String)">XQQueryException</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message)</CODE> <BR> Constructs an <code>XQQueryException</code> object with a given message.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#XQQueryException(java.lang.String, javax.xml.namespace.QName)">XQQueryException</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode)</CODE> <BR> Constructs an <code>XQQueryException</code> object with a given message, and error code.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#XQQueryException(java.lang.String, javax.xml.namespace.QName, int, int, int)">XQQueryException</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position)</CODE> <BR> Constructs an <code>XQQueryException</code> object with a given message, error code, line number, column number, and position.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#XQQueryException(java.lang.String, java.lang.String, javax.xml.namespace.QName, int, int, int)">XQQueryException</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> vendorCode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position)</CODE> <BR> Constructs an <code>XQQueryException</code> object with a given message, vendor code, error code, line number, column number, and position.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#XQQueryException(java.lang.String, java.lang.String, javax.xml.namespace.QName, int, int, int, java.lang.String, javax.xml.xquery.XQSequence, javax.xml.xquery.XQStackTraceElement[])">XQQueryException</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> vendorCode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> moduleURI, <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> errorObject, <A HREF="../../../javax/xml/xquery/XQStackTraceElement.html" title="class in javax.xml.xquery">XQStackTraceElement</A>[] stackTrace)</CODE> <BR> Constructs an <code>XQQueryException</code> object with a given message, vendor code, error code, line number, column number, position, module URI, error object, and stack trace.</TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Method Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getColumnNumber()">getColumnNumber</A></B>()</CODE> <BR> Gets the column number in the query string where the error occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getErrorCode()">getErrorCode</A></B>()</CODE> <BR> Gets the code identifying the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"><i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"><i> Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; imlementation-defined errors may also be raised; finally the error code may also be specified in the query using <code>fn:error()</code>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getErrorObject()">getErrorObject</A></B>()</CODE> <BR> Gets an <code>XQSequence</code> representing the error object passed to <code>fn:error()</code>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getLineNumber()">getLineNumber</A></B>()</CODE> <BR> Gets the line number in the query string where the error occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getModuleURI()">getModuleURI</A></B>()</CODE> <BR> Gets the module URI of the module in which the error occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getPosition()">getPosition</A></B>()</CODE> <BR> Gets the character position in the query string where this exception occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../javax/xml/xquery/XQStackTraceElement.html" title="class in javax.xml.xquery">XQStackTraceElement</A>[]</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../javax/xml/xquery/XQQueryException.html#getQueryStackTrace()">getQueryStackTrace</A></B>()</CODE> <BR> Returns the query stack stackTrace when the exception occurred, or null if none.</TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_javax.xml.xquery.XQException"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class javax.xml.xquery.<A HREF="../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../javax/xml/xquery/XQException.html#getNextException()">getNextException</A>, <A HREF="../../../javax/xml/xquery/XQException.html#getVendorCode()">getVendorCode</A>, <A HREF="../../../javax/xml/xquery/XQException.html#setNextException(javax.xml.xquery.XQException)">setNextException</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#fillInStackTrace()" title="class or interface in java.lang">fillInStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getCause()" title="class or interface in java.lang">getCause</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getLocalizedMessage()" title="class or interface in java.lang">getLocalizedMessage</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getMessage()" title="class or interface in java.lang">getMessage</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#getStackTrace()" title="class or interface in java.lang">getStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#initCause(java.lang.Throwable)" title="class or interface in java.lang">initCause</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace()" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace(java.io.PrintStream)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#printStackTrace(java.io.PrintWriter)" title="class or interface in java.lang">printStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#setStackTrace(java.lang.StackTraceElement[])" title="class or interface in java.lang">setStackTrace</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Throwable.html?is-external=true#toString()" title="class or interface in java.lang">toString</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> </TR> </TABLE> <P> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TH> </TR> </TABLE> <A NAME="XQQueryException(java.lang.String)"><!-- --></A><H3> XQQueryException</H3> <PRE> public <B>XQQueryException</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message)</PRE> <DL> <DD>Constructs an <code>XQQueryException</code> object with a given message. <P> <DL> <DT><B>Parameters:</B><DD><CODE>message</CODE> - the description of the error. <code>null</code> indicates that the message string is non existant</DL> </DL> <HR> <A NAME="XQQueryException(java.lang.String, javax.xml.namespace.QName)"><!-- --></A><H3> XQQueryException</H3> <PRE> public <B>XQQueryException</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode)</PRE> <DL> <DD>Constructs an <code>XQQueryException</code> object with a given message, and error code. <P> <DL> <DT><B>Parameters:</B><DD><CODE>message</CODE> - the description of the error. <code>null</code> indicates that the message string is non existant<DD><CODE>errorCode</CODE> - <code>QName</code> which identifies the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"> <i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"> <i>Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; implementation-defined errors may be raised.</li></DL> </DL> <HR> <A NAME="XQQueryException(java.lang.String, javax.xml.namespace.QName, int, int, int)"><!-- --></A><H3> XQQueryException</H3> <PRE> public <B>XQQueryException</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position)</PRE> <DL> <DD>Constructs an <code>XQQueryException</code> object with a given message, error code, line number, column number, and position. <P> <DL> <DT><B>Parameters:</B><DD><CODE>message</CODE> - the description of the error. <code>null</code> indicates that the message string is non existant<DD><CODE>errorCode</CODE> - <code>QName</code> which identifies the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"> <i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"> <i>Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; implementation-defined errors may be raised</li><DD><CODE>line</CODE> - the line number in the query string where the error occured. Line numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>column</CODE> - the column number in the query string where the error occured. Column numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>position</CODE> - the position in the query string where the error occured. This is a <code>0</code> based position. <code>-1</code> if unknown</DL> </DL> <HR> <A NAME="XQQueryException(java.lang.String, java.lang.String, javax.xml.namespace.QName, int, int, int)"><!-- --></A><H3> XQQueryException</H3> <PRE> public <B>XQQueryException</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> vendorCode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position)</PRE> <DL> <DD>Constructs an <code>XQQueryException</code> object with a given message, vendor code, error code, line number, column number, and position. <P> <DL> <DT><B>Parameters:</B><DD><CODE>message</CODE> - the description of the error. <code>null</code> indicates that the message string is non existant<DD><CODE>vendorCode</CODE> - a vendor-specific string identifying the error. <code>null</code> indicates there is no vendor code or it is unknown<DD><CODE>errorCode</CODE> - <code>QName</code> which identifies the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"> <i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"> <i>Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; implementation-defined errors may be raised</li><DD><CODE>line</CODE> - the line number in the query string where the error occured. Line numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>column</CODE> - the column number in the query string where the error occured. Column numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>position</CODE> - the position in the query string where the error occured. This is a <code>0</code> based position. <code>-1</code> if unknown</DL> </DL> <HR> <A NAME="XQQueryException(java.lang.String, java.lang.String, javax.xml.namespace.QName, int, int, int, java.lang.String, javax.xml.xquery.XQSequence, javax.xml.xquery.XQStackTraceElement[])"><!-- --></A><H3> XQQueryException</H3> <PRE> public <B>XQQueryException</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> message, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> vendorCode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> errorCode, int line, int column, int position, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> moduleURI, <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> errorObject, <A HREF="../../../javax/xml/xquery/XQStackTraceElement.html" title="class in javax.xml.xquery">XQStackTraceElement</A>[] stackTrace)</PRE> <DL> <DD>Constructs an <code>XQQueryException</code> object with a given message, vendor code, error code, line number, column number, position, module URI, error object, and stack trace. <P> <DL> <DT><B>Parameters:</B><DD><CODE>message</CODE> - the description of the error. <code>null</code> indicates that the message string is non existant<DD><CODE>vendorCode</CODE> - a vendor-specific string identifying the error. <code>null</code> indicates there is no vendor code or it is unknown<DD><CODE>errorCode</CODE> - <code>QName</code> which identifies the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"> <i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"> <i>Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; implementation-defined errors may be raised</li><DD><CODE>line</CODE> - the line number in the query string where the error occured. Line numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>column</CODE> - the column number in the query string where the error occured. Column numbering starts at <code>1</code>. <code>-1</code> if unknown<DD><CODE>position</CODE> - the position in the query string where the error occured. This is a <code>0</code> based position. <code>-1</code> if unknown<DD><CODE>moduleURI</CODE> - the module URI of the module in which the error occurred. <code>null</code> when it is the main module or when the module is unknown<DD><CODE>errorObject</CODE> - an <code>XQSequence</code> representing the error object passed to <code>fn:error()</code>. <code>null</code> if this error was not triggered by <code>fn:error()</code> or when the error object is not available.<DD><CODE>stackTrace</CODE> - the XQuery stack trace where the error occurred. <code>null</code> if not available</DL> </DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Method Detail</B></FONT></TH> </TR> </TABLE> <A NAME="getErrorCode()"><!-- --></A><H3> getErrorCode</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> <B>getErrorCode</B>()</PRE> <DL> <DD>Gets the code identifying the error according to the standard as described in <a href="http://www.w3.org/TR/xquery/#id-errors"><i>Appendix F, XQuery 1.0: An XML Query language</i></a>, <a href="http://www.w3.org/TR/xpath-functions/#error-summary"><i> Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators</i></a>, and its associated specifications; imlementation-defined errors may also be raised; finally the error code may also be specified in the query using <code>fn:error()</code>. <P> <DD><DL> <DT><B>Returns:</B><DD>the code identifying the error, or <code>null</code> if not available</DL> </DD> </DL> <HR> <A NAME="getErrorObject()"><!-- --></A><H3> getErrorObject</H3> <PRE> public <A HREF="../../../javax/xml/xquery/XQSequence.html" title="interface in javax.xml.xquery">XQSequence</A> <B>getErrorObject</B>()</PRE> <DL> <DD>Gets an <code>XQSequence</code> representing the error object passed to <code>fn:error()</code>. Returns <code>null</code> if this error was not triggered by <code>fn:error()</code> or when the error object is not available. <P> <DD><DL> <DT><B>Returns:</B><DD>the sequence passed to <code>fn:error()</code>, <code>null</code> if not available</DL> </DD> </DL> <HR> <A NAME="getPosition()"><!-- --></A><H3> getPosition</H3> <PRE> public int <B>getPosition</B>()</PRE> <DL> <DD>Gets the character position in the query string where this exception occurred. <p> This is a <code>0</code> based position. <code>-1</code> if unknown.</li> <P> <DD><DL> <DT><B>Returns:</B><DD>the character position in the query string where the exception occurred</DL> </DD> </DL> <HR> <A NAME="getQueryStackTrace()"><!-- --></A><H3> getQueryStackTrace</H3> <PRE> public <A HREF="../../../javax/xml/xquery/XQStackTraceElement.html" title="class in javax.xml.xquery">XQStackTraceElement</A>[] <B>getQueryStackTrace</B>()</PRE> <DL> <DD>Returns the query stack stackTrace when the exception occurred, or null if none. On some implementations only the top frame may be visible. <P> <DD><DL> <DT><B>Returns:</B><DD>the stackTrace where the exception occurred</DL> </DD> </DL> <HR> <A NAME="getModuleURI()"><!-- --></A><H3> getModuleURI</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getModuleURI</B>()</PRE> <DL> <DD>Gets the module URI of the module in which the error occurred. <code>null</code> when it is the main module or when the module is unknown. <P> <DD><DL> <DT><B>Returns:</B><DD>the module URI or <code>null</code></DL> </DD> </DL> <HR> <A NAME="getLineNumber()"><!-- --></A><H3> getLineNumber</H3> <PRE> public int <B>getLineNumber</B>()</PRE> <DL> <DD>Gets the line number in the query string where the error occurred. <p> Line numbering starts at <code>1</code>. <code>-1</code> is returned if the line number is unknown. If the implementation does not support this method, it must return <code>-1</code> <P> <DD><DL> <DT><B>Returns:</B><DD>the line number in the query string where the error occurred</DL> </DD> </DL> <HR> <A NAME="getColumnNumber()"><!-- --></A><H3> getColumnNumber</H3> <PRE> public int <B>getColumnNumber</B>()</PRE> <DL> <DD>Gets the column number in the query string where the error occurred. <p> Column numbering starts at <code>1</code>. <code>-1</code> is returned if the column number is unknown. If the implementation does not support this method, it must return <code>-1</code> <P> <DD><DL> <DT><B>Returns:</B><DD>the column number in the query string where the error occurred</DL> </DD> </DL> <!-- ========= END OF CLASS DATA ========= --> <HR> <!-- ======= START OF BOTTOM NAVBAR ====== --> <A NAME="navbar_bottom"><!-- --></A> <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_bottom_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../javax/xml/xquery/XQPreparedExpression.html" title="interface in javax.xml.xquery"><B>PREV CLASS</B></A> <A HREF="../../../javax/xml/xquery/XQResultItem.html" title="interface in javax.xml.xquery"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?javax/xml/xquery/XQQueryException.html" target="_top"><B>FRAMES</B></A> <A HREF="XQQueryException.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> Copyright (c) 2004-2011 Saxonica Limited. All rights reserved. </BODY> </HTML>