com.ibm.xml.xapi

Class XProcessException

  1. java.lang.Object
  2. extended byjava.lang.Throwable
  3. extended byjava.lang.Exception
  4. extended byjava.lang.RuntimeException
  5. extended bycom.ibm.xml.xapi.XProcessException
All implemented interfaces:
java.io.Serializable

  1. public class XProcessException
  2. extends java.lang.RuntimeException
Base exception for XML processing.

This exception is thrown when the processor finds a non-recoverable error when preparing or executing an expression, query, or stylesheet as described in the specifications for each language.

If there are multiple errors at prepare time, the processor attempts to report all of the errors and only throws an XProcessException at the end of preparation or if it reaches a point where it cannot continue. At execution time, however, the first error results in an XProcessException and the end of execution.

In general, XProcessExceptions should not occur if the expression, query, or stylesheet is syntactically and semantically valid and also valid for the types of input documents that it is meant to process.

An XProcessException is also thrown for an XSLT message instruction where the terminate attribute evaluates to "yes."

This is the default behaviour for handling processing errors and other messages. Applications can register an implementation of the XMessageHandler interface on the XFactory or at prepare time or execution time to modify the default behaviour.

See Also:
XMessageHandler, XFactory.setMessageHandler(XMessageHandler), XStaticContext.setMessageHandler(XMessageHandler), XDynamicContext.setMessageHandler(XMessageHandler), Serialized Form

Constructor Summary

Constructor and Description
XProcessException(java.lang.String message,java.lang.Throwable cause)

Method Summary

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

XProcessException

  1. public XProcessException(java.lang.String message,
  2. java.lang.Throwable cause)