org.apache.fop.render.afp.exceptions
Class NestedRuntimeException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.apache.fop.render.afp.exceptions.NestedRuntimeException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

FontRuntimeException, RendererRuntimeException

public abstract class NestedRuntimeException

extends java.lang.RuntimeException

Handy class for wrapping runtime Exceptions with a root cause. This technique is no longer necessary in Java 1.4, which provides built-in support for exception nesting. Thus exceptions in applications written to use Java 1.4 need not extend this class.

See Also:

Serialized Form

Constructor Summary

NestedRuntimeException(java.lang.String msg)
Construct a NestedRuntimeException with the specified detail message.

NestedRuntimeException(java.lang.String msg, java.lang.Throwable t)
Construct a NestedRuntimeException with the specified detail message and nested exception.

Method Summary

java.lang.String	getMessage() Return the detail message, including the message from the nested exception if there is one.
java.lang.Throwable	getUnderlyingException() Gets the original triggering exception
void	printStackTrace(java.io.PrintStream ps) Print the composite message and the embedded stack trace to the specified stream.
void	printStackTrace(java.io.PrintWriter pw) Print the composite message and the embedded stack trace to the specified writer.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

NestedRuntimeException

public NestedRuntimeException(java.lang.String msg)

Construct a NestedRuntimeException with the specified detail message.

Parameters:

msg - The detail message.

NestedRuntimeException

public NestedRuntimeException(java.lang.String msg,
                              java.lang.Throwable t)

Construct a NestedRuntimeException with the specified detail message and nested exception.

Parameters:

msg - The detail message.

t - The nested exception.

Method Detail

getUnderlyingException

public java.lang.Throwable getUnderlyingException()

Gets the original triggering exception

Returns:

The original exception as a throwable.

getMessage

public java.lang.String getMessage()

Return the detail message, including the message from the nested exception if there is one.

Returns:

The detail message.

printStackTrace

public void printStackTrace(java.io.PrintStream ps)

Print the composite message and the embedded stack trace to the specified stream.

Parameters:

ps - the print stream

printStackTrace

public void printStackTrace(java.io.PrintWriter pw)

Print the composite message and the embedded stack trace to the specified writer.

Parameters:

pw - the print writer