API

com.ibm.xml.xapi
Class XProcessException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by com.ibm.xml.xapi.XProcessException
All Implemented Interfaces:
Serializable

public class XProcessException
extends 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
XProcessException(String message, 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

public XProcessException(String message,
                         Throwable cause)

IBM Copyright 2004-2008