jrunx.tyrex.util
Class NestedException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--jrunx.tyrex.util.NestedException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

DomainConfigurationException, RecoveryException

public abstract class NestedException

extends java.lang.Exception

Base type for all Type exceptions.

This exception can optionally wrap another exception. The printed stack trace will be that of the wrapped exception, if one is provided in the constructor. The underlying exception can be obtained from getException.

Several exceptions support wrapping of an underlying exception by extending from this class. When another nested exception is provided in the constructor, the underlying exception will be used, so it's safe to construct a nested exception from another nested exception.

Support for unwrapping the underlying exceptions include NestedException, SAXException.

See Also:

Serialized Form

Field Summary

static java.lang.String

DEFAULT_MESSAGE

Constructor Summary

NestedException(java.lang.Exception except)
Construct a new nested exception wrapping an underlying exception.

NestedException(java.lang.String message)
Construct a new nested with a message.

NestedException(java.lang.String message, java.lang.Exception except)
Construct a new nested exception wrapping an underlying exception and providing a message.

Method Summary

java.lang.Exception	getException() Returns the underlying exception, if this exception wraps another exception.
void	printStackTrace()
void	printStackTrace(java.io.PrintStream stream)
void	printStackTrace(java.io.PrintWriter writer)

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage, toString

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MESSAGE

public static final java.lang.String DEFAULT_MESSAGE

Constructor Detail

NestedException

public NestedException(java.lang.String message,
                       java.lang.Exception except)

Construct a new nested exception wrapping an underlying exception and providing a message.

Parameters:

message - The exception message

except - The underlying exception

NestedException

public NestedException(java.lang.String message)

Construct a new nested with a message.

Parameters:

message - The exception message

NestedException

public NestedException(java.lang.Exception except)

Construct a new nested exception wrapping an underlying exception.

Parameters:

except - The underlying exception

Method Detail

getException

public java.lang.Exception getException()

Returns the underlying exception, if this exception wraps another exception.

Returns:

The underlying exception, or null

printStackTrace

public void printStackTrace()

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream stream)

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintWriter writer)

Overrides:

printStackTrace in class java.lang.Throwable