TransformerException - Android SDK

Interfaces
Classes
Exceptions
- TransformerConfigurationException
- TransformerException
Errors
- TransformerFactoryConfigurationError

Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 8

public class

TransformerException

extends Exception

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

Known Direct Subclasses

TransformerConfigurationException

Class Overview

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

Summary

Public Constructors
	TransformerException(String message) Create a new TransformerException.
	TransformerException(Throwable e) Create a new TransformerException wrapping an existing exception.
	TransformerException(String message, Throwable e) Wrap an existing exception in a TransformerException.
	TransformerException(String message, SourceLocator locator) Create a new TransformerException from a message and a Locator.
	TransformerException(String message, SourceLocator locator, Throwable e) Wrap an existing exception in a TransformerException.

Public Methods
Throwable	getCause() Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
Throwable	getException() This method retrieves an exception that this exception wraps.
String	getLocationAsString() Get the location information as a string.
SourceLocator	getLocator() Method getLocator retrieves an instance of a SourceLocator object that specifies where an error occurred.
String	getMessageAndLocation() Get the error message with location information appended.
synchronized Throwable	initCause(Throwable cause) Initializes the cause of this throwable to the specified value.
void	printStackTrace(PrintWriter s) Print the the trace of methods from where the error originated.
void	printStackTrace(PrintStream s) Print the the trace of methods from where the error originated.
void	printStackTrace() Print the the trace of methods from where the error originated.
void	setLocator(SourceLocator location) Method setLocator sets an instance of a SourceLocator object that specifies where an error occurred.

[Expand]

Inherited Methods

From class java.lang.Throwable

final void	addSuppressed(Throwable throwable) Adds `throwable` to the list of throwables suppressed by this.
Throwable	fillInStackTrace() Records the stack trace from the point where this method has been called to this `Throwable`.
Throwable	getCause() Returns the cause of this `Throwable`, or `null` if there is no cause.
String	getLocalizedMessage() Returns the detail message which was provided when this `Throwable` was created.
String	getMessage() Returns the detail message which was provided when this `Throwable` was created.
StackTraceElement[]	getStackTrace() Returns a clone of the array of stack trace elements of this `Throwable`.
final Throwable[]	getSuppressed() Returns the throwables suppressed by this.
Throwable	initCause(Throwable throwable) Initializes the cause of this `Throwable`.
void	printStackTrace(PrintStream err) Writes a printable representation of this `Throwable`'s stack trace to the given print stream.
void	printStackTrace(PrintWriter err) Writes a printable representation of this `Throwable`'s stack trace to the specified print writer.
void	printStackTrace() Writes a printable representation of this `Throwable`'s stack trace to the `System.err` stream.
void	setStackTrace(StackTraceElement[] trace) Sets the array of stack trace elements.
String	toString() Returns a string containing a concise, human-readable description of this object.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public TransformerException (String message)

Added in API level 8

Create a new TransformerException.

Parameters

message	The error or warning message.

public TransformerException (Throwable e)

Added in API level 8

Create a new TransformerException wrapping an existing exception.

Parameters

e	The exception to be wrapped.

public TransformerException (String message, Throwable e)

Added in API level 8

Wrap an existing exception in a TransformerException.

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

Parameters

message	The error or warning message, or null to use the message from the embedded exception.
e	Any exception

public TransformerException (String message, SourceLocator locator)

Added in API level 8

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.

Parameters

message	The error or warning message.
locator	The locator object for the error or warning.

public TransformerException (String message, SourceLocator locator, Throwable e)

Added in API level 8

Wrap an existing exception in a TransformerException.

Parameters

message	The error or warning message, or null to use the message from the embedded exception.
locator	The locator object for the error or warning.
e	Any exception

Public Methods

public Throwable getCause ()

Added in API level 8

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 ()

Added in API level 8

This method retrieves an exception that this exception wraps.

Returns

An Throwable object, or null.

public String getLocationAsString ()

Added in API level 8

Get the location information as a string.

Returns

A string with location info, or null if there is no location information.

public SourceLocator getLocator ()

Added in API level 8

Method getLocator retrieves an instance of a SourceLocator object that specifies where an error occurred.

Returns

A SourceLocator object, or null if none was specified.

public String getMessageAndLocation ()

Added in API level 8

Get the error message with location information appended.

Returns

A String representing the error message with location information appended.

public synchronized Throwable initCause (Throwable cause)

Added in API level 8

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.

Parameters

cause	the 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.)

Returns

a reference to this Throwable instance.

Throws

IllegalArgumentException	if `cause` is this throwable. (A throwable cannot be its own cause.)
IllegalStateException	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 (PrintWriter s)

Added in API level 8

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.

public void printStackTrace (PrintStream s)

Added in API level 8

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.

public void printStackTrace ()

Added in API level 8

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 setLocator (SourceLocator location)

Added in API level 8

Method setLocator sets an instance of a SourceLocator object that specifies where an error occurred.

Parameters

location	A SourceLocator object, or null to clear the location.

Results

Interfaces

Classes

Exceptions

Errors

TransformerException

Class Overview

Summary

Public Constructors

public TransformerException (String message)

Parameters

public TransformerException (Throwable e)

Parameters

public TransformerException (String message, Throwable e)

Parameters

public TransformerException (String message, SourceLocator locator)

Parameters

public TransformerException (String message, SourceLocator locator, Throwable e)

Parameters

Public Methods

public Throwable getCause ()

public Throwable getException ()

Returns

See Also

public String getLocationAsString ()

Returns

public SourceLocator getLocator ()

Returns

public String getMessageAndLocation ()

Returns

public synchronized Throwable initCause (Throwable cause)

Parameters

Returns

Throws

public void printStackTrace (PrintWriter s)

Parameters

public void printStackTrace (PrintStream s)

Parameters

public void printStackTrace ()

public void setLocator (SourceLocator location)

Parameters