javax.xml.xquery
public class XQException extends Exception
XQException
provides several kinds of information:
getMessage
.getCause
.getVendorCode
. Refer to the vendor documentation
which specific codes can be returned.XQException
objects. If more than one
error occurred the exceptions are referenced via this chain.XQException
has a subclass
XQQueryException
providing more detailed
information about errors that occurred during the processing of a query.
An implementation throws a base XQException
when an error
occurs in the XQJ implementation. Further, implementations are encouraged to
use the more detailed XQQueryException
in case of an
error reported by the XQuery engine.
XQException
, there is a possibility that there may be
additional XQException
objects chained to the original
thrown XQException
. To access the additional chained
XQException
objects, an application would recursively
invoke getNextException
until a null
value is
returned.
XQException
may have a causal relationship, which
consists of one or more Throwable
instances which caused
the XQException
to be thrown. The application may
recursively call the method getCause
, until a null
value is returned, to navigate the chain of causes.
Constructor Summary | |
---|---|
XQException(String message)
Constructs an XQException object with a given message.
| |
XQException(String message, String vendorCode)
Constructs an XQException object with a given message
and vendor code. |
Method Summary | |
---|---|
XQException | getNextException()
Returns the next XQException in the chain or
null if none.
|
String | getVendorCode()
Gets the vendor code associated with this exception or null
if none. |
void | setNextException(XQException next)
Adds an XQException to the chain of exceptions.
|
XQException
object with a given message.
An optional chain of additional XQException
objects may be set
subsequently using setNextException
.
Parameters: message the description of the error. null
indicates
that the message string is non existant
XQException
object with a given message
and vendor code. An optional chain of additional
XQException
objects may be set subsequently using
setNextException
.
Parameters: message the description of the error. null
indicates that the message string is non existant vendorCode a vendor-specific string identifying the error.
null
indicates there is no vendor
code or it is unknown
XQException
in the chain or
null
if none.
Returns: the next exception, or null
if none
null
if none. A vendor code is a vendor-specific string identifying the failure in
a computer-comparable manner. For example, "NOCONNECT" if unable to
connect or "DIVBYZERO" if division by zero occurred within the XQuery.
Returns: the vendor code string, or null
if none available
XQException
to the chain of exceptions.
Parameters: next the next exception to be added to the chain of exceptions