Fills in the execution stack trace.

  Fills in the execution stack trace. This method records within this
Throwable object information about the current state of
the stack frames for the current thread.
Returns: a reference to this Throwable instance.
See Also: Throwable.printStackTrace(),

  Returns the cause of this throwable or null if the cause is nonexistent or unknown.

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

  This method retrieves an exception that this exception wraps.

  This method retrieves an exception that this exception wraps.
Returns: An Throwable object, or null.
See Also: TransformerException.getCause(),

  Creates a localized description of this throwable.

  Creates a localized description of this throwable.
Subclasses may override this method in order to produce a
locale-specific message. For subclasses that do not override this
method, the default implementation returns the same result as
getMessage().
Returns: The localized description of this throwable.
Since: JDK1.1

  Get the location information as a string.

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

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

  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.

  Returns the detail message string of this throwable.

  Returns the detail message string of this throwable.
Returns: the detail message string of this Throwable instance (which may be null).

  Get the error message with location information appended.

  Get the error message with location information
appended.
Returns: A String representing the error message with location information appended.

  Provides programmatic access to the stack trace information printed by Throwable.printStackTrace().

  Provides programmatic access to the stack trace information printed by Throwable.printStackTrace(). Returns an array of stack trace elements, each representing one stack frame. The zeroth element of the array (assuming the array's length is non-zero) represents the top of the stack, which is the last method invocation in the sequence. Typically, this is the point at which this throwable was created and thrown. The last element of the array (assuming the array's length is non-zero) represents the bottom of the stack, which is the first method invocation in the sequence.

Some virtual machines may, under some circumstances, omit one or more stack frames from the stack trace. In the extreme case, a virtual machine that has no stack trace information concerning this throwable is permitted to return a zero-length array from this method. Generally speaking, the array returned by this method will contain one element for every frame that would be printed by printStackTrace.
Returns: an array of stack trace elements representing the stack trace pertaining to this throwable.
Since: 1.4

  Initializes the cause of this throwable to the specified value.

  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.TransformerException(Throwable) or TransformerException.TransformerException(String,Throwable), this method cannot be called even once.
Returns: a reference to this Throwable instance.
Parameters:
- cause - the cause (which is saved for later retrieval by the {@link #getCause()} method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
Throws:
- IllegalArgumentException - if cause is this throwable. (A throwable cannot be its own cause.)
- IllegalStateException - if this throwable was created with {@link #TransformerException(Throwable)} or {@link #TransformerException(String,Throwable)}, or this method has already been called on this throwable.

  Print the the trace of methods from where the error originated.

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

  Print the the trace of methods from where the error originated.

  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.

  Print the the trace of methods from where the error originated.

  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.

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

  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.

  Sets the stack trace elements that will be returned by Throwable.getStackTrace() and printed by Throwable.printStackTrace() and related methods.

  Sets the stack trace elements that will be returned by
Throwable.getStackTrace() and printed by Throwable.printStackTrace()
and related methods.

This method, which is designed for use by RPC frameworks and other
advanced systems, allows the client to override the default
stack trace that is either generated by Throwable.fillInStackTrace()
when a throwable is constructed or deserialized when a throwable is
read from a serialization stream.
Parameters:
- stackTrace - the stack trace elements to be associated with this Throwable. The specified array is copied by this call; changes in the specified array after the method invocation returns will have no affect on this Throwable's stack trace.
Throws:
- NullPointerException - if stackTrace is null, or if any of the elements of stackTrace are null
Since: 1.4

  Returns a short description of this throwable.

  Returns a short description of this throwable.
The result is the concatenation of:

• the name of the class of this object
  
• ": " (a colon and a space)
  
• the result of invoking this object's Throwable.getLocalizedMessage()
  method
  

If getLocalizedMessage returns null, then just
the class name is returned.
Returns: a string representation of this throwable.