org.springframework.core

Class NestedExceptionUtils

java.lang.Object

org.springframework.core.NestedExceptionUtils

public abstract class NestedExceptionUtils
extends Object

Helper class for implementing exception classes which are capable of holding nested exceptions. Necessary because we can't share a base class among different exception types.

Mainly for use within the framework.

Since:

2.0

Author:

Juergen Hoeller

See Also:

NestedRuntimeException, NestedCheckedException, NestedIOException, NestedServletException

Constructor Summary

Constructors

Constructor and Description
NestedExceptionUtils()

Method Summary

Modifier and Type	Method and Description
static String	buildMessage(String message, Throwable cause) Build a message for the given base message and root cause.
static Throwable	getMostSpecificCause(Throwable original) Retrieve the most specific cause of the given exception, that is, either the innermost cause (root cause) or the exception itself.
static Throwable	getRootCause(Throwable original) Retrieve the innermost cause of the given exception, if any.

Methods inherited from class java.lang.Object

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

Constructor Detail

NestedExceptionUtils

public NestedExceptionUtils()

Method Detail

buildMessage

@Nullable
public static String buildMessage(@Nullable
                                            String message,
                                            @Nullable
                                            Throwable cause)

Build a message for the given base message and root cause.

Parameters:

message - the base message

cause - the root cause

Returns:

the full exception message

getRootCause

@Nullable
public static Throwable getRootCause(@Nullable
                                               Throwable original)

Retrieve the innermost cause of the given exception, if any.

Parameters:

original - the original exception to introspect

Returns:

the innermost exception, or null if none

Since:

4.3.9

getMostSpecificCause

public static Throwable getMostSpecificCause(Throwable original)

Retrieve the most specific cause of the given exception, that is, either the innermost cause (root cause) or the exception itself.

Differs from getRootCause(java.lang.Throwable) in that it falls back to the original exception if there is no root cause.

Parameters:

original - the original exception to introspect

Returns:

the most specific cause (never null)

Since:

4.3.9