org.pentaho.reporting.libraries.base.util

Class StackableException

public class StackableException extends Exception

A baseclass for exceptions, which could have parent exceptions. These parent exceptions are raised in a subclass and are now wrapped into a subclass of this Exception.

The parents are printed when this exception is printed. This class exists mainly for debugging reasons, as with them it is easier to detect the root cause of an error.

Author: Thomas Morgner

UNKNOWN: UseOfSystemOutOrSystemErr

Method Summary
StringgetMessage()
Returns the detail message string of this throwable.
ExceptiongetParent()
Returns the parent exception (possibly null).
ThrowablegetParentThrowable()
voidprintStackTrace(PrintStream stream)
Prints the stack trace to the specified stream.
voidprintStackTrace(PrintWriter writer)
Prints the stack trace to the specified writer.
voidprintStackTrace()
Prints this Throwable and its backtrace to the standard error stream.
StringtoString()
Returns a short description of this throwable.

Method Detail

getMessage

public String getMessage()
Returns the detail message string of this throwable.

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

getParent

public Exception getParent()

Deprecated: use the throwable instead.

Returns the parent exception (possibly null).

Returns: the parent exception.

getParentThrowable

public Throwable getParentThrowable()

printStackTrace

public void printStackTrace(PrintStream stream)
Prints the stack trace to the specified stream.

Parameters: stream the output stream.

printStackTrace

public void printStackTrace(PrintWriter writer)
Prints the stack trace to the specified writer.

Parameters: writer the writer.

printStackTrace

public void printStackTrace()
Prints this Throwable and its backtrace to the standard error stream. This method prints a stack trace for this Throwable object on the error output stream that is the value of the field System.err. The first line of output contains the result of the toString method for this object. Remaining lines represent data previously recorded by the method StackableException. The format of this information depends on the implementation, but the following example may be regarded as typical:
 java.lang.NullPointerException
         at MyClass.mash(MyClass.java:9)
         at MyClass.crunch(MyClass.java:6)
         at MyClass.main(MyClass.java:3)
 
This example was produced by running the program:
 

class MyClass {

public static void main(String[] argv) { crunch(null); } static void crunch(int[] a) { mash(a); }

static void mash(int[] b) { System.out.println(b[0]); } }

See Also: System#err

toString

public String toString()
Returns a short description of this throwable. If this Throwable object was created with a non-null detail message string, then the result is the concatenation of three strings: If this Throwable object was created with a null detail message string, then the name of the actual class of this object is returned.

Returns: a string representation of this throwable.