org.webmacro
Class RethrowableRuntimeException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byorg.webmacro.RethrowableRuntimeException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
WebMacroRuntimeException

public class RethrowableRuntimeException
extends java.lang.RuntimeException

RethrowableRuntimeException A standard exception, inherited from RuntimeException, which also includes a constructor of the form Exception(String, Exception) which allows one exception to wrap another without throwing away useful debugging information. The PrintStackTrace routine will print the stack trace for both the original exception and the point at which the exception was rethrown.

Since:
0.96
Author:
Brian Goetz (Quiotix Corp)
See Also:
Serialized Form

Constructor Summary
RethrowableRuntimeException()
           
RethrowableRuntimeException(java.lang.String s)
           
RethrowableRuntimeException(java.lang.String s, java.lang.Throwable e)
           
 
Method Summary
 java.lang.Throwable getCaught()
          Deprecated. you should use getCause instead
 java.lang.Throwable getCause()
          Return the underlying exception provided at construction time or null if none was provided.
 java.lang.Throwable getRootCause()
          Return the original exception cause.
 void printStackTrace()
           
 void printStackTrace(java.io.PrintStream ps)
           
 void printStackTrace(java.io.PrintWriter pw)
           
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

RethrowableRuntimeException

public RethrowableRuntimeException()

RethrowableRuntimeException

public RethrowableRuntimeException(java.lang.String s)

RethrowableRuntimeException

public RethrowableRuntimeException(java.lang.String s,
                                   java.lang.Throwable e)
Method Detail

printStackTrace

public void printStackTrace()

printStackTrace

public void printStackTrace(java.io.PrintStream ps)

printStackTrace

public void printStackTrace(java.io.PrintWriter pw)

getCaught

public java.lang.Throwable getCaught()
Deprecated. you should use getCause instead

allow access to underlying exception


getCause

public java.lang.Throwable getCause()
Return the underlying exception provided at construction time or null if none was provided.

Returns:
underlying cause
Since:
1.1

getRootCause

public java.lang.Throwable getRootCause()
Return the original exception cause. This will recursively extract the cause if cause is a subclass of RethrowableException.

Returns:
underlying root cause
Since:
1.1