|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.lang.Throwable java.lang.Exception javax.xml.xquery.XQException javax.xml.xquery.XQQueryException
public class XQQueryException
An exception that provides information on errors occurring during the
evaluation of an xquery.
Each XQQueryException
provides several kinds of optional
information, in addition to the properties inherited from
XQException
:
QName
identifies the error
according to the standard as described in
Appendix F, XQuery 1.0:
An XML Query language,
Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators, and
and its associated specifications; implementation-defined errors may be raised.0
based position. -1
if unknown.1
. -1
if unknown1
. -1
if unknownnull
when the error is located in the main module.$error-object
argument specified through the fn:error()
function. May be null
if not specified.
Constructor Summary | |
---|---|
XQQueryException(String message)
Constructs an XQQueryException object with a given message. |
|
XQQueryException(String message,
QName errorCode)
Constructs an XQQueryException object with a given message,
and error code. |
|
XQQueryException(String message,
QName errorCode,
int line,
int column,
int position)
Constructs an XQQueryException object with a given message,
error code, line number, column number, and position. |
|
XQQueryException(String message,
String vendorCode,
QName errorCode,
int line,
int column,
int position)
Constructs an XQQueryException object with a given message,
vendor code, error code, line number, column number, and position. |
|
XQQueryException(String message,
String vendorCode,
QName errorCode,
int line,
int column,
int position,
String moduleURI,
XQSequence errorObject,
XQStackTraceElement[] stackTrace)
Constructs an XQQueryException object with a given message,
vendor code, error code, line number, column number, position, module URI,
error object, and stack trace. |
Method Summary | |
---|---|
int |
getColumnNumber()
Gets the column number in the query string where the error occurred. |
QName |
getErrorCode()
Gets the code identifying the error according to the standard as described in Appendix F, XQuery 1.0: An XML Query language, Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators, and its associated specifications; imlementation-defined errors may also be raised; finally the error code may also be specified in the query using fn:error() . |
XQSequence |
getErrorObject()
Gets an XQSequence representing the error object passed to
fn:error() . |
int |
getLineNumber()
Gets the line number in the query string where the error occurred. |
String |
getModuleURI()
Gets the module URI of the module in which the error occurred. |
int |
getPosition()
Gets the character position in the query string where this exception occurred. |
XQStackTraceElement[] |
getQueryStackTrace()
Returns the query stack stackTrace when the exception occurred, or null if none. |
Methods inherited from class javax.xml.xquery.XQException |
---|
getNextException, getVendorCode, setNextException |
Methods inherited from class java.lang.Throwable |
---|
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public XQQueryException(String message)
XQQueryException
object with a given message.
message
- the description of the error. null
indicates
that the message string is non existantpublic XQQueryException(String message, QName errorCode)
XQQueryException
object with a given message,
and error code.
message
- the description of the error. null
indicates
that the message string is non existanterrorCode
- QName
which identifies the error
according to the standard as described in
Appendix F, XQuery 1.0: An XML Query language,
Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators,
and its associated specifications; implementation-defined
errors may be raised.public XQQueryException(String message, QName errorCode, int line, int column, int position)
XQQueryException
object with a given message,
error code, line number, column number, and position.
message
- the description of the error. null
indicates
that the message string is non existanterrorCode
- QName
which identifies the error
according to the standard as described in
Appendix F, XQuery 1.0: An XML Query language,
Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators,
and its associated specifications; implementation-defined
errors may be raisedline
- the line number in the query string where the error occured.
Line numbering starts at 1
. -1
if unknowncolumn
- the column number in the query string where the error occured.
Column numbering starts at 1
. -1
if unknownposition
- the position in the query string where the error occured. This
is a 0
based position. -1
if unknownpublic XQQueryException(String message, String vendorCode, QName errorCode, int line, int column, int position)
XQQueryException
object with a given message,
vendor code, error code, line number, column number, and position.
message
- the description of the error. null
indicates
that the message string is non existantvendorCode
- a vendor-specific string identifying the error.
null
indicates there is no vendor
code or it is unknownerrorCode
- QName
which identifies the error
according to the standard as described in
Appendix F, XQuery 1.0: An XML Query language,
Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators,
and its associated specifications; implementation-defined
errors may be raisedline
- the line number in the query string where the error occured.
Line numbering starts at 1
. -1
if unknowncolumn
- the column number in the query string where the error occured.
Column numbering starts at 1
. -1
if unknownposition
- the position in the query string where the error occured. This
is a 0
based position. -1
if unknownpublic XQQueryException(String message, String vendorCode, QName errorCode, int line, int column, int position, String moduleURI, XQSequence errorObject, XQStackTraceElement[] stackTrace)
XQQueryException
object with a given message,
vendor code, error code, line number, column number, position, module URI,
error object, and stack trace.
message
- the description of the error. null
indicates
that the message string is non existantvendorCode
- a vendor-specific string identifying the error.
null
indicates there is no vendor
code or it is unknownerrorCode
- QName
which identifies the error
according to the standard as described in
Appendix F, XQuery 1.0: An XML Query language,
Appendix C, XQuery 1.0 and XPath 2.0 Functions and Operators,
and its associated specifications; implementation-defined
errors may be raisedline
- the line number in the query string where the error occured.
Line numbering starts at 1
. -1
if unknowncolumn
- the column number in the query string where the error occured.
Column numbering starts at 1
. -1
if unknownposition
- the position in the query string where the error occured. This
is a 0
based position. -1
if unknownmoduleURI
- the module URI of the module in which the error occurred.
null
when it is the main module or when the module is
unknownerrorObject
- an XQSequence
representing the error object passed to
fn:error()
. null
if this error was not
triggered by fn:error()
or when the error object is
not available.stackTrace
- the XQuery stack trace where the error occurred. null
if not availableMethod Detail |
---|
public QName getErrorCode()
fn:error()
.
null
if not availablepublic XQSequence getErrorObject()
XQSequence
representing the error object passed to
fn:error()
. Returns null
if this error was not triggered by
fn:error()
or when the error object is not available.
fn:error()
,
null
if not availablepublic int getPosition()
This is a 0
based position. -1
if unknown.
public XQStackTraceElement[] getQueryStackTrace()
public String getModuleURI()
null
when it is the main module or when the module is
unknown.
null
public int getLineNumber()
Line numbering starts at 1
. -1
is returned
if the line number is unknown. If the implementation does not support this method,
it must return -1
public int getColumnNumber()
Column numbering starts at 1
. -1
is returned
if the column number is unknown. If the implementation does not support this method,
it must return -1
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |