jade.util

Class WrapperException

java.lang.Object

java.lang.Throwable

java.lang.Exception

jade.util.WrapperException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ContentException, FrameException

public abstract class WrapperException
extends Exception

This class acts as a base class for all the exceptions that wrap another (nested) exception. The typical usage for descendents of this class is to throw them within the catch block for their nested exception.

Version:

0.9

Author:

Giovanni Rimassa - Universita' di Parma

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Throwable	nested

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WrapperException(String m) Create a wrapper exception with the given message.
protected	WrapperException(String m, Throwable t) Create a wrapper exception with the given message and nested exception.

Method Summary

Modifier and Type	Method and Description
String	getMessage() Retrieve the exception message text.
Throwable	getNested() Reads the exception wrapped by this object.
void	printStackTrace(PrintWriter pw) Prints the stack trace of this exception.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

nested

private Throwable nested

Constructor Detail

WrapperException

protected WrapperException(String m,
                           Throwable t)

Create a wrapper exception with the given message and nested exception.

Parameters:

m - The exception message text.

t - The nested exception that caused this one.

WrapperException

protected WrapperException(String m)

Create a wrapper exception with the given message.

Parameters:

m - The exception message text.

Method Detail

getMessage

public String getMessage()

Retrieve the exception message text.

Overrides:

getMessage in class Throwable

Returns:

The exception message, including the nested exception text if present.

printStackTrace

public void printStackTrace(PrintWriter pw)

Prints the stack trace of this exception. If a nested exception is present, its stack trace is also printed.

Overrides:

printStackTrace in class Throwable

getNested

public Throwable getNested()

Reads the exception wrapped by this object.

Returns:

the Throwable object that is the exception that was originally thrown.