tyrex.util
Class NestedException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          tyrex.util.NestedException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

DomainConfigurationException, RecoveryException, ResourceException

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.

Version:

$Revision: 1.2 $

Author:

Assaf Arkin

See Also:

Serialized Form

Field Summary

Fields inherited from class java.lang.Exception

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, getCause, 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

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()

printStackTrace

public void printStackTrace(java.io.PrintStream stream)

printStackTrace

public void printStackTrace(java.io.PrintWriter writer)