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 implementation returns the cause that was supplied via one of the constructors requiring a Throwable, or that was set after creation with the Throwable.initCause(Throwable) method. While it is typically unnecessary to override this method, a subclass can override it to return a cause set by some other means. This is appropriate for a "legacy chained throwable" that predates the addition of chained exceptions to Throwable. Note that it is not necessary to override any of the PrintStackTrace methods, all of which invoke the getCause method to determine the cause of a throwable.
Returns: the cause of this throwable or null if the cause is nonexistent or unknown.
Since: 1.4

  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

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

  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 Throwable.Throwable(Throwable) or Throwable.Throwable(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 #Throwable(Throwable)} or {@link #Throwable(String,Throwable)}, or this method has already been called on this throwable.
Since: 1.4

  Prints this throwable and its backtrace to the specified print writer.

  Prints this throwable and its backtrace to the specified
print writer.
Parameters:
- s - PrintWriter to use for output
Since: JDK1.1

  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