com.qizx.api
Class EvaluationException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.qizx.api.QizxException
              com.qizx.api.EvaluationException

All Implemented Interfaces:

Serializable

public class EvaluationException

extends QizxException

Exception thrown by an error in the execution of an XQuery Expression.

See Also:

Serialized Form

Field Summary

static QName	CANCELLED Error code used when the evaluation has been explicitly cancelled.
protected static QName	DEFAULT_ERR_CODE
static QName	TIME_LIMIT Error code used when the time limit for evaluation has been reached.

Fields inherited from class com.qizx.api.QizxException

errorCode

Constructor Summary

EvaluationException(QName xqueryCode, String message)
Constructs an EvaluationException from a simple message and an error code.

EvaluationException(QName xqueryCode, String message, Throwable cause)
Constructs an EvaluationException from a simple message, an error code and an exception.

EvaluationException(String message)
Constructs an EvaluationException from a simple message.

EvaluationException(String message, Throwable cause)
Constructs an EvaluationException from a simple message and an exception.

Method Summary

EvaluationStackTrace[]	getStack() Returns the execution stack at the moment of the error.
void	setStack(EvaluationStackTrace[] stack) For internal use.

Methods inherited from class com.qizx.api.QizxException

getErrorCode, setErrorCode, setErrorCode

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

Field Detail

TIME_LIMIT

public static final QName TIME_LIMIT

Error code used when the time limit for evaluation has been reached.

CANCELLED

public static final QName CANCELLED

Error code used when the evaluation has been explicitly cancelled.

DEFAULT_ERR_CODE

protected static final QName DEFAULT_ERR_CODE

Constructor Detail

EvaluationException

public EvaluationException(String message)

Constructs an EvaluationException from a simple message. The error code is undefined.

EvaluationException

public EvaluationException(QName xqueryCode,
                           String message)

Constructs an EvaluationException from a simple message and an error code.

EvaluationException

public EvaluationException(String message,
                           Throwable cause)

Constructs an EvaluationException from a simple message and an exception. The error code is undefined.

EvaluationException

public EvaluationException(QName xqueryCode,
                           String message,
                           Throwable cause)

Constructs an EvaluationException from a simple message, an error code and an exception.

Method Detail

getStack

public EvaluationStackTrace[] getStack()

Returns the execution stack at the moment of the error.

Returns:

an array of EvaluationStackTrace objects. The first array element corresponds to the innermost execution level. The last element corresponds to the main query.

setStack

public void setStack(EvaluationStackTrace[] stack)

For internal use.