com.sas.net.util
Class WrapperException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--com.sas.net.util.WrapperException

All Implemented Interfaces:

Direct Known Subclasses:

ConnectException, TelnetClientException

public abstract class WrapperException

extends Exception

Base class for exceptions that may contain nested exceptions. When there is a nested exception, toString() and printStackTrace(), etc. defer to the nested exception.

If the nested exception is itself a WrapperException, then there will be yet another layer of deferal.

This is for checked exceptions. There is also a RuntimeWrapperException to use as a base class for unchecked exceptions.

Java has it's own notion of a wrapper exception in java.lang.reflect.InvocationTargetException. This class would not exist were it not for three problems with InvocationTargetException.

• The semantics of InvocationTargetException imply that a method was called through reflection while the semantics here are more general.
• There is not unchecked equivalent of InvocationTargetException.
• InvocationTargetException does not properly defer to the nestedException until JDK 1.2.

This base class is often useful in the following situation where AnException extends WrapperException: public void aMethod() throws AnException { try { doStuff(); } catch (AnotherException e) { throw new AnException(e); } }

See Also:

Serialized Form

Constructor Summary

WrapperException()
No-argument constructor.

WrapperException(String message)
Constructor with message.

WrapperException(String message, Throwable nestedException)
Wrapper constructor.

WrapperException(Throwable nestedException)
Wrapper constructor.

Method Summary

Throwable	fillInStackTrace()
String	getLocalizedMessage()
String	getMessage()
Throwable	getNestedException() Gets the nested exception.
void	printStackTrace()
void	printStackTrace(PrintStream p)
void	printStackTrace(PrintWriter p)
String	toString()

Methods inherited from class java.lang.Throwable

getCause, getStackTrace, initCause, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

WrapperException

public WrapperException()

No-argument constructor.

WrapperException

public WrapperException(String message)

Constructor with message.

Parameters:

message - a message adding detail to the exception

WrapperException

public WrapperException(Throwable nestedException)

Wrapper constructor.

Parameters:

nestedException - exception being wrapped

WrapperException

public WrapperException(String message,
                        Throwable nestedException)

Wrapper constructor.

Parameters:

message - a message to include in the exception.

nestedException - an exception being wrapped.

Method Detail

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

See Also:

Throwable.getMessage()

getLocalizedMessage

public String getLocalizedMessage()

Overrides:

getLocalizedMessage in class Throwable

See Also:

Throwable.getLocalizedMessage()

toString

public String toString()

Overrides:

toString in class Throwable

See Also:

Throwable.toString()

printStackTrace

public void printStackTrace()

Overrides:

printStackTrace in class Throwable

See Also:

Throwable.printStackTrace()

printStackTrace

public void printStackTrace(PrintStream p)

Overrides:

printStackTrace in class Throwable

See Also:

Throwable.printStackTrace()

printStackTrace

public void printStackTrace(PrintWriter p)

Overrides:

printStackTrace in class Throwable

See Also:

Throwable.printStackTrace()

fillInStackTrace

public Throwable fillInStackTrace()

Overrides:

fillInStackTrace in class Throwable

See Also:

Throwable.fillInStackTrace()

getNestedException

public Throwable getNestedException()

Gets the nested exception.

Returns:

The nested exception.