org.pentaho.reporting.libraries.base.util

Class StackableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.pentaho.reporting.libraries.base.util.StackableException

All Implemented Interfaces:

Serializable

Deprecated.

Use ordinary exception as your base class.

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

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StackableException() Deprecated. Creates a StackableRuntimeException with no message and no parent.
protected	StackableException(String message) Deprecated. Creates an exception.
protected	StackableException(String message, Exception ex) Deprecated. use the throwable-version instead.
protected	StackableException(String message, Throwable ex) Deprecated. Creates an exception.

Method Summary

Modifier and Type	Method and Description
String	getMessage() Deprecated. Returns the detail message string of this throwable.
Exception	getParent() Deprecated. use the throwable instead.
Throwable	getParentThrowable() Deprecated.
void	printStackTrace() Deprecated. Prints this Throwable and its backtrace to the standard error stream.
void	printStackTrace(PrintStream stream) Deprecated. Prints the stack trace to the specified stream.
void	printStackTrace(PrintWriter writer) Deprecated. Prints the stack trace to the specified writer.
String	toString() Deprecated. Returns a short description of this throwable.
protected void	update(String message, Throwable parent) Deprecated.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

StackableException

protected StackableException()

Deprecated.

Creates a StackableRuntimeException with no message and no parent.

StackableException

protected StackableException(String message,
                             Throwable ex)

Deprecated.

Creates an exception.

Parameters:

message - the exception message.

ex - the parent exception.

StackableException

protected StackableException(String message,
                             Exception ex)

Deprecated. use the throwable-version instead.

Creates an exception.

Parameters:

message - the exception message.

ex - the parent exception.

StackableException

protected StackableException(String message)

Deprecated.

Creates an exception.

Parameters:

message - the exception message.

Method Detail

getParent

public Exception getParent()

Deprecated. use the throwable instead.

Returns the parent exception (possibly null).

Returns:

the parent exception.

update

protected void update(String message,
                      Throwable parent)

Deprecated.

getParentThrowable

public Throwable getParentThrowable()

Deprecated.

getMessage

public String getMessage()

Deprecated.

Returns the detail message string of this throwable.

Overrides:

getMessage in class Throwable

Returns:

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

toString

public String toString()

Deprecated.

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:

• The name of the actual class of this object
• ": " (a colon and a space)
• The result of the getMessage() method for this object

If this Throwable object was created with a null detail message string, then the name of the actual class of this object is returned.

Overrides:

toString in class Throwable

Returns:

a string representation of this throwable.

printStackTrace

public void printStackTrace(PrintStream stream)

Deprecated.

Prints the stack trace to the specified stream.

Overrides:

printStackTrace in class Throwable

Parameters:

stream - the output stream.

printStackTrace

public void printStackTrace(PrintWriter writer)

Deprecated.

Prints the stack trace to the specified writer.

Overrides:

printStackTrace in class Throwable

Parameters:

writer - the writer.

printStackTrace

public void printStackTrace()

Deprecated.

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 Throwable.fillInStackTrace(). 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]);
     }
 }
 

Overrides:

printStackTrace in class Throwable

See Also:

System.err