org.apache.xpath

Class XPathException

public class XPathException extends TransformerException

This class implements an exception object that all XPath classes will throw in case of an error. This class extends TransformerException, and may hold other exceptions. In the case of nested exceptions, printStackTrace will dump all the traces of the nested exceptions, not just the trace of this object.

UNKNOWN: general

Constructor Summary
	XPathException(String message, ExpressionNode ex) Create an XPathException object that holds an error message.
	XPathException(String message) Create an XPathException object that holds an error message.
	XPathException(String message, Object styleNode) Create an XPathException object that holds an error message and the stylesheet node that the error originated from.
	XPathException(String message, Node styleNode, Exception e) Create an XPathException object that holds an error message, the stylesheet node that the error originated from, and another exception that caused this exception.
	XPathException(String message, Exception e) Create an XPathException object that holds an error message, and another exception that caused this exception.

Method Summary
Throwable	getException() Return the embedded exception, if any.
String	getMessage() Find the most contained message.
Object	getStylesheetNode() Get the stylesheet node from where this error originated.
Node	getStylesheetNode(ExpressionNode ex) Get the XSLT ElemVariable that this sub-expression references.
void	printStackTrace(PrintStream s) Print the the trace of methods from where the error originated.
void	printStackTrace(PrintWriter s) Print the the trace of methods from where the error originated.
void	setStylesheetNode(Object styleNode) Set the stylesheet node from where this error originated.

Constructor Detail

XPathException

public XPathException(String message, ExpressionNode ex)

Create an XPathException object that holds an error message.

Parameters: message The error message.

XPathException

public XPathException(String message)

Create an XPathException object that holds an error message.

Parameters: message The error message.

XPathException

public XPathException(String message, Object styleNode)

Create an XPathException object that holds an error message and the stylesheet node that the error originated from.

Parameters: message The error message. styleNode The stylesheet node that the error originated from.

XPathException

public XPathException(String message, Node styleNode, Exception e)

Create an XPathException object that holds an error message, the stylesheet node that the error originated from, and another exception that caused this exception.

Parameters: message The error message. styleNode The stylesheet node that the error originated from. e The exception that caused this exception.

XPathException

public XPathException(String message, Exception e)

Create an XPathException object that holds an error message, and another exception that caused this exception.

Parameters: message The error message. e The exception that caused this exception.

Method Detail

getException

public Throwable getException()

Return the embedded exception, if any. Overrides javax.xml.transform.TransformerException.getException().

Returns: The embedded exception, or null if there is none.

getMessage

public String getMessage()

Find the most contained message.

Returns: The error message of the originating exception.

getStylesheetNode

public Object getStylesheetNode()

Get the stylesheet node from where this error originated.

Returns: The stylesheet node from where this error originated, or null.

getStylesheetNode

public Node getStylesheetNode(ExpressionNode ex)

Get the XSLT ElemVariable that this sub-expression references. In order for this to work, the SourceLocator must be the owning ElemTemplateElement.

Returns: The dereference to the ElemVariable, or null if not found.

printStackTrace

public void printStackTrace(PrintStream s)

Print the the trace of methods from where the error originated. This will trace all nested exception objects, as well as this object.

Parameters: s The stream where the dump will be sent to.

printStackTrace

public void printStackTrace(PrintWriter s)

Print the the trace of methods from where the error originated. This will trace all nested exception objects, as well as this object.

Parameters: s The writer where the dump will be sent to.

setStylesheetNode

public void setStylesheetNode(Object styleNode)

Set the stylesheet node from where this error originated.

Parameters: styleNode The stylesheet node from where this error originated, or null.