org.apache.maven.surefire.util

Class NestedRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.maven.surefire.util.NestedRuntimeException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ReporterException, SurefireReflectionException

public class NestedRuntimeException
extends RuntimeException

Copied from Spring framework to keep Java 1.3 compatability.

Handy class for wrapping runtime Exceptions with a root cause.

This time-honoured technique is no longer necessary in Java 1.4, which finally provides built-in support for exception nesting. Thus exceptions in applications written to use Java 1.4 need not extend this class. To ease migration, this class mirrors Java 1.4's nested exceptions as closely as possible.

Abstract to force the programmer to extend the class. getMessage will include nested exception information; printStackTrace etc will delegate to the wrapped exception, if any.

The similarity between this class and the NestedCheckedException class is unavoidable, as Java forces these two classes to have different superclasses (ah, the inflexibility of concrete inheritance!).

As discussed in Expert One-On-One J2EE Design and Development, runtime exceptions are often a better alternative to checked exceptions. However, all exceptions should preserve their stack trace, if caused by a lower-level exception.

Author:

Rod Johnson, Juergen Hoeller

See Also:

getMessage(), printStackTrace(java.io.PrintStream), NestedCheckedException, Serialized Form

Constructor Summary

Constructors

Constructor and Description
NestedRuntimeException(String msg, Throwable ex) Construct a NestedRuntimeException with the specified detail message and nested exception.
NestedRuntimeException(Throwable ex) Construct a NestedRuntimeException with the specified nested exception.

Method Summary

Methods

Modifier and Type	Method and Description
Throwable	getCause() Return the nested cause, or null if none.
String	getMessage() Return the detail message, including the message from the nested exception if there is one.
void	printStackTrace(PrintStream ps) Print the composite message and the embedded stack trace to the specified stream.
void	printStackTrace(PrintWriter pw) Print the composite message and the embedded stack trace to the specified writer.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, 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(String msg,
                      Throwable ex)

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

Parameters:

msg - the detail message

ex - the nested exception

NestedRuntimeException

public NestedRuntimeException(Throwable ex)

Construct a NestedRuntimeException with the specified nested exception.

Parameters:

ex - the nested exception

Method Detail

getCause

public Throwable getCause()

Return the nested cause, or null if none.

Note that this will only check one level of nesting. Use getRootCause() to retrieve the innermost cause.

Overrides:

getCause in class Throwable

getMessage

public String getMessage()

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

Overrides:

getMessage in class Throwable

printStackTrace

public void printStackTrace(PrintStream ps)

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

Overrides:

printStackTrace in class Throwable

Parameters:

ps - the print stream

printStackTrace

public void printStackTrace(PrintWriter pw)

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

Overrides:

printStackTrace in class Throwable

Parameters:

pw - the print writer