javax.xml.transform
Class TransformerException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.transform.TransformerException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

TransformerConfigurationException

public class TransformerException
extends Exception

An exception occurred during the transformation process.

See Also:

Serialized Form

Constructor Summary

TransformerException(String msg)
Constructor with a detail message.

TransformerException(String msg, SourceLocator locator)
Constructor with a detail message and locator.

TransformerException(String msg, SourceLocator locator, Throwable cause)
Constructor with detail message, locator and underlying cause.

TransformerException(String msg, Throwable cause)
Constructor with a detail message and underlying cause.

TransformerException(Throwable cause)
Constructor with an underlying cause.

Method Summary

Throwable	getCause() Returns the underlying cause of this exception.
Throwable	getException() Returns the underlying cause of this exception.
String	getLocationAsString() Returns the location information as a string.
SourceLocator	getLocator() Returns a locator indicating where the error occurred.
String	getMessageAndLocation() Returns the exception message with location information appended.
Throwable	initCause(Throwable cause) Initializes the root cause of this exception.
void	printStackTrace() Print stack trace of this Throwable to System.err.
void	printStackTrace(PrintStream s) Print the stack trace of this Throwable to the given stream.
void	printStackTrace(PrintWriter s) Print the stack trace of this Throwable to the given PrintWriter.
void	setLocator(SourceLocator location) Sets the locator indicating where the error occurred.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TransformerException

public TransformerException(String msg)

Constructor with a detail message.

TransformerException

public TransformerException(Throwable cause)

Constructor with an underlying cause.

TransformerException

public TransformerException(String msg,
                            Throwable cause)

Constructor with a detail message and underlying cause.

TransformerException

public TransformerException(String msg,
                            SourceLocator locator)

Constructor with a detail message and locator.

TransformerException

public TransformerException(String msg,
                            SourceLocator locator,
                            Throwable cause)

Constructor with detail message, locator and underlying cause.

Method Detail

getLocator

public SourceLocator getLocator()

Returns a locator indicating where the error occurred.

setLocator

public void setLocator(SourceLocator location)

Sets the locator indicating where the error occurred.

getException

public Throwable getException()

Returns the underlying cause of this exception.

getCause

public Throwable getCause()

Returns the underlying cause of this exception.

Overrides:

getCause in class Throwable

Returns:

The cause or null.

initCause

public Throwable initCause(Throwable cause)

Initializes the root cause of this exception. This method may be called only once, and will be called by the constructor if a non-null cause is specified. Really phenomenally poor API design.

Overrides:

initCause in class Throwable

Parameters:

cause - the underlying cause

Returns:

the reference to this Throwable.

Throws:

IllegalArgumentException - if this exception is passed as the argument

IllegalStateException - if a cause has already been initialized

getMessageAndLocation

public String getMessageAndLocation()

Returns the exception message with location information appended.

getLocationAsString

public String getLocationAsString()

Returns the location information as a string.

printStackTrace

public void printStackTrace()

Description copied from class: Throwable

Print stack trace of this Throwable to System.err.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number if available.

For JamaicaVM, this routine also works before System was initialized by using low-level exception printing mechanisms provided by class com.aicas.jamaica.lang.Debug.

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)

Description copied from class: Throwable

Print the stack trace of this Throwable to the given stream.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number if available.

For JamaicaVM, if printing to the stream causes another exception, low-level exception printing mechanisms provided by class com.aicas.jamaica.lang.Debug will be used to print the exception to stderr.

Overrides:

printStackTrace in class Throwable

Parameters:

s - the stream to print to.

printStackTrace

public void printStackTrace(PrintWriter s)

Description copied from class: Throwable

Print the stack trace of this Throwable to the given PrintWriter.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number if available.

For JamaicaVM, if printing to the PrintWriter causes another exception, low-level exception printing mechanisms provided by class com.aicas.jamaica.lang.Debug will be used to print the exception to stderr.

Overrides:

printStackTrace in class Throwable

Parameters:

s - the PrintWriter to write to.