| java.lang.Object java.lang.Throwable java.lang.Exception org.springframework.core.NestedCheckedException
All known Subclasses: org.springframework.jdbc.support.MetaDataAccessException,
NestedCheckedException | abstract public class NestedCheckedException extends Exception (Code) | | Handy class for wrapping checked Exceptions with a root cause.
This time-honored 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.
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: NestedCheckedException.getMessage See Also: NestedCheckedException.printStackTrace See Also: NestedRuntimeException |
Method Summary | |
public boolean | contains(Class exType) 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. | public Throwable | getCause() Return the nested cause, or null if none. | public String | getMessage() Return the detail message, including the message from the nested exception
if there is one. | public Throwable | getMostSpecificCause() Retrieve the most specific cause of this exception, that is,
either the innermost cause (root cause) or this exception itself. | public Throwable | getRootCause() Retrieve the innermost cause of this exception, if any.
Currently just traverses NestedCheckedException causes. | public void | printStackTrace(PrintStream ps) Print the composite message and the embedded stack trace to the specified stream. | public void | printStackTrace(PrintWriter pw) Print the composite message and the embedded stack trace to the specified print writer. |
NestedCheckedException | public NestedCheckedException(String msg)(Code) | | Construct a NestedCheckedException with the specified detail message.
Parameters: msg - the detail message |
NestedCheckedException | public NestedCheckedException(String msg, Throwable cause)(Code) | | Construct a NestedCheckedException with the specified detail message
and nested exception.
Parameters: msg - the detail message Parameters: cause - the nested exception |
contains | public boolean contains(Class exType)(Code) | | 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.
Currently just traverses NestedCheckedException causes.
Will use the JDK 1.4 exception cause mechanism once Spring requires JDK 1.4.
Parameters: exType - the exception type to look for whether there is a nested exception of the specified type |
getMessage | public String getMessage()(Code) | | Return the detail message, including the message from the nested exception
if there is one.
|
getMostSpecificCause | public Throwable getMostSpecificCause()(Code) | | Retrieve the most specific cause of this exception, that is,
either the innermost cause (root cause) or this exception itself.
Differs from
NestedCheckedException.getRootCause() in that it falls back
to the present exception if there is no root cause.
the most specific cause (never null ) since: 2.0.3 |
getRootCause | public Throwable getRootCause()(Code) | | Retrieve the innermost cause of this exception, if any.
Currently just traverses NestedCheckedException causes. Will use
the JDK 1.4 exception cause mechanism once Spring requires JDK 1.4.
the innermost exception, or null if none |
printStackTrace | public void printStackTrace(PrintStream ps)(Code) | | Print the composite message and the embedded stack trace to the specified stream.
Parameters: ps - the print stream |
printStackTrace | public void printStackTrace(PrintWriter pw)(Code) | | Print the composite message and the embedded stack trace to the specified print writer.
Parameters: pw - the print writer |
|
|