com.varra.exception

Class ChainedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.varra.exception.ChainedException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ComputingException, JMXWrapperException, Log4jConfigLoaderException, PropertyFileLoaderException

public class ChainedException
extends Exception

This Exception is the base class for the this Exception module.
It extends the Exception class and adds Chaining feature. Through the use of chaining, stack traces of all the exceptions in the chain can be maintained.

This class overrides the printStackTrace() method of Exception class and prints the stack trace of both the Exceptions (the original exception and the exception that is replacing the original exception).
Taken from the article Exceptional practices, Part 2 by Brian Goetz, JavaWorld Oct 2001

Version:

1.0

Author:

Rajakrishna V. Reddy

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ChainedException() Constructor.
ChainedException(String message) Constructor.
ChainedException(String message, Throwable cause) Useful for revealing the original error with a bonus message.
ChainedException(Throwable cause) Useful for revealing the original error.

Method Summary

Modifier and Type	Method and Description
Throwable	getCause() Gets the cause of the actual exception.
void	printStackTrace() Overridden method to include the stack trace of the original exception.
void	printStackTrace(PrintStream ps) Overridden method to include the stack trace of the original exception.
void	printStackTrace(PrintWriter pw) Overridden method to include the stack trace of the original exception.
String	toString()

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ChainedException

public ChainedException()

Constructor.

ChainedException

public ChainedException(String message)

Constructor.

Parameters:

message - message representing the cause of exception

ChainedException

public ChainedException(String message,
                        Throwable cause)

Useful for revealing the original error with a bonus message. Constructor takes a string and something throwable. Adds the throwable item to a collection that can later be dumped out by toString() and/or printStackTrace()

Parameters:

message - message representing the cause of exception

cause - Exception that needs to be chained

ChainedException

public ChainedException(Throwable cause)

Useful for revealing the original error. Constructor takes something throwable and adds it to a collection that can later be dumped out by toString() and/or printStackTrace()

Parameters:

cause - Exception that needs to be chained

Method Detail

getCause

public Throwable getCause()

Gets the cause of the actual exception.

Overrides:

getCause in class Throwable

Returns:

the cause

See Also:

Throwable.getCause()

printStackTrace

public void printStackTrace()

Overridden method to include the stack trace of the original exception.

Overrides:

printStackTrace in class Throwable

See Also:

Throwable.printStackTrace()

printStackTrace

public void printStackTrace(PrintStream ps)

Overridden method to include the stack trace of the original exception.

Overrides:

printStackTrace in class Throwable

Parameters:

ps - the ps

See Also:

Throwable.printStackTrace(java.io.PrintStream)

printStackTrace

public void printStackTrace(PrintWriter pw)

Overridden method to include the stack trace of the original exception.

Overrides:

printStackTrace in class Throwable

Parameters:

pw - the pw

See Also:

Throwable.printStackTrace(java.io.PrintWriter)

toString

public String toString()

Overrides:

toString in class Throwable