spring-framework / org.springframework.core / NestedCheckedException

NestedCheckedException

abstract class NestedCheckedException : Exception

Handy class for wrapping checked Exceptions with a root cause.

This class is abstract to force the programmer to extend the class. getMessage will include nested exception information; printStackTrace and other like methods will delegate to the wrapped exception, if any.

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

Author
Rod Johnson

Author
Juergen Hoeller

See Also
#getMessage #printStackTraceNestedRuntimeException

Constructors

<init>

NestedCheckedException(msg: String)

Construct a NestedCheckedException with the specified detail message.

NestedCheckedException(msg: String, cause: Throwable)

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

Properties

message

open val message: String

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

Functions

contains

open fun contains(exType: Class<*>): Boolean

Check whether this exception contains an exception of the given type: either it is of the given class itself or it contains a nested cause of the given type.

getMostSpecificCause

open fun getMostSpecificCause(): Throwable

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

Differs from #getRootCause() in that it falls back to the present exception if there is no root cause.

getRootCause

open fun getRootCause(): Throwable

Retrieve the innermost cause of this exception, if any.

Inheritors

MetaDataAccessException

open class MetaDataAccessException : NestedCheckedException

Exception indicating that something went wrong during JDBC metadata lookup.

This is a checked exception since we want it to be caught, logged and handled rather than cause the application to fail. Failure to read JDBC metadata is usually not a fatal problem.