Google

: Class TransformerException
Overview  Package   Class  Tree  Deprecated  Index  Help 
 NEXT CLASS FRAMES    NO FRAMES
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD


Class TransformerException

java.lang.Object

  |

  +--java.lang.Throwable

        |

        +--java.lang.Exception

              |
All Implemented Interfaces:
java.io.Serializable
public class TransformerException
extends java.lang.Exception

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


          Create a new TransformerException.
          Create a new TransformerException from a message and a Locator. java.lang.Throwable e)
          Wrap an existing exception in a TransformerException. java.lang.Throwable e)
          Wrap an existing exception in a TransformerException.
          Create a new TransformerException wrapping an existing exception.
Constructor Summary
 
          Returns the cause of this throwable or null if the cause is nonexistent or unknown.
          This method retrieves an exception that this exception wraps.
          Get the location information as a string.
          Get the error message with location information appended.
          Initializes the cause of this throwable to the specified value.
          Print the the trace of methods from where the error originated.
          Print the the trace of methods from where the error originated.
          Print the the trace of methods from where the error originated.
          Method setLocator sets an instance of a SourceLocator object that specifies where an error occured.
Method Summary
 java.lang.Throwable
 java.lang.Throwable
 java.lang.String

          Method getLocator retrieves an instance of a SourceLocator object that specifies where an error occured.
 java.lang.String
 java.lang.Throwable
 void
 void
 void
 void
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TransformerException

public TransformerException(java.lang.String message)
Create a new TransformerException.
Parameters:
message - The error or warning message.

TransformerException

public TransformerException(java.lang.Throwable e)
Create a new TransformerException wrapping an existing exception.
Parameters:
e - The exception to be wrapped.

TransformerException

public TransformerException(java.lang.String message,
                            java.lang.Throwable e)
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
TransformerException 
public TransformerException(java.lang.String message,





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.














TransformerException


public TransformerException(java.lang.String message,
                            java.lang.Throwable e)






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























Method Detail












getLocator








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



Returns:
A SourceLocator object, or null if none was specified.














setLocator







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



Parameters:
location - A SourceLocator object, or null to clear the location.
















getException



public java.lang.Throwable getException()






This method retrieves an exception that this exception wraps.

















getCause



public java.lang.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.)










initCause



public java.lang.Throwable initCause(java.lang.Throwable cause)






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
 even once.



Parameters:
cause - the cause (which is saved for later retrieval by the
         permitted, and indicates that the cause is nonexistent or
         unknown.)
Returns:
a reference to this Throwable instance.
Throws:
java.lang.IllegalArgumentException - if cause is this
         throwable.  (A throwable cannot
         be its own cause.)
java.lang.IllegalStateException - if this throwable was
         been called on this throwable.
















getMessageAndLocation



public java.lang.String getMessageAndLocation()






Get the error message with location information
 appended.










getLocationAsString



public java.lang.String getLocationAsString()






Get the location information as a string.



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
















printStackTrace



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.



Overrides:
printStackTrace in class java.lang.Throwable
















printStackTrace



public void printStackTrace(java.io.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.



Overrides:
printStackTrace in class java.lang.Throwable









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
















printStackTrace



public void printStackTrace(java.io.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.



Overrides:
printStackTrace in class java.lang.Throwable









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






























  


      Overview 

      Package 

    Class 

      Tree 

      Deprecated 

      Index 

      Help 

  
























 NEXT CLASS



  FRAMES   

 NO FRAMES









  SUMMARY:  INNER | FIELD | CONSTR | METHOD



DETAIL:  FIELD | CONSTR | METHOD