public class javax.xml.transform
TransformerException


Show All Login
Java SE 6
  
Extends: Throwable > Exception
Extended by: TransformerConfigurationException

This class specifies an exceptional condition that occured during the transformation process.

Constructors
public TransformerException(String message) Details
Create a new TransformerException.
messageThe error or warning message.
public TransformerException(Throwable e) Details
Create a new TransformerException wrapping an existing exception.
eThe exception to be wrapped.
public TransformerException(String message, Throwable e) Details
Wrap an existing exception in a TransformerException.

This is used for throwing processor exceptions before the processing has started.

messageThe error or warning message, or null to use the message from the embedded exception.
eAny exception
public TransformerException(String message, SourceLocator locator) Details
Create a new TransformerException from a message and a Locator.

This constructor is especially useful when an application is creating its own exception from within a DocumentHandler callback.

messageThe error or warning message.
locatorThe locator object for the error or warning.
public TransformerException(String message, SourceLocator locator, Throwable e) Details
Wrap an existing exception in a TransformerException.
messageThe error or warning message, or null to use the message from the embedded exception.
locatorThe locator object for the error or warning.
eAny exception

Methods
public Throwable initCause(Throwable cause) Details
Initializes the cause of this throwable to the specified value. (The cause is the throwable that caused this throwable to get thrown.)

This method can be called at most once. It is generally called from within the constructor, or immediately after creating the throwable. If this throwable was created with #TransformerException(Throwable) or #TransformerException(String,Throwable), this method cannot be called even once.
causethe cause (which is saved for later retrieval by the #getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
returna reference to this Throwable instance.
ThrowsIllegalArgumentException: if cause is this throwable. (A throwable cannot be its own cause.)
ThrowsIllegalStateException: if this throwable was created with #TransformerException(Throwable) or #TransformerException(String,Throwable), or this method has already been called on this throwable.

public void printStackTrace()
Print the the trace of methods from where the error originated. This will trace all nested exception objects, as well as this object.
public void printStackTrace(PrintStream s) Details
Print the the trace of methods from where the error originated. This will trace all nested exception objects, as well as this object.
sThe stream where the dump will be sent to.
public void printStackTrace(PrintWriter s) Details
Print the the trace of methods from where the error originated. This will trace all nested exception objects, as well as this object.
sThe writer where the dump will be sent to.

Properties
public Throwable getCause()
Returns the cause of this throwable or null if the cause is nonexistent or unknown. (The cause is the throwable that caused this throwable to get thrown.)
public Throwable getException() Details
This method retrieves an exception that this exception wraps.
returnAn Throwable object, or null.
See also getCause
public String getLocationAsString() Details
Get the location information as a string.
returnA string with location info, or null if there is no location information.
public void setLocator(SourceLocator location) Details
Method setLocator sets an instance of a SourceLocator object that specifies where an error occured.
locationA SourceLocator object, or null to clear the location.
public SourceLocator getLocator() Details
Method getLocator retrieves an instance of a SourceLocator object that specifies where an error occured.
returnA SourceLocator object, or null if none was specified.
public String getMessageAndLocation() Details
Get the error message with location information appended.
returnA String representing the error message with location information appended.