|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Throwable
java.lang.Exception
org.springframework.core.NestedCheckedException
Handy class for wrapping checked 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.
getMessage()
,
printStackTrace(java.io.PrintStream)
,
Serialized FormField Summary |
Fields inherited from class java.lang.Exception |
|
Constructor Summary | |
NestedCheckedException(java.lang.String msg)
Construct a ExceptionWrapperException with the specified detail message. |
|
NestedCheckedException(java.lang.String msg,
java.lang.Throwable ex)
Construct a RemoteException with the specified detail message
and nested exception. |
Method Summary | |
java.lang.Throwable |
getCause()
Return the nested cause, or null if none. |
java.lang.String |
getMessage()
Return the detail message, including the message from the nested exception if there is one. |
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 print writer. |
Methods inherited from class java.lang.Throwable |
fillInStackTrace, 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 |
public NestedCheckedException(java.lang.String msg)
ExceptionWrapperException
with the specified detail message.
msg
- the detail messagepublic NestedCheckedException(java.lang.String msg, java.lang.Throwable ex)
RemoteException
with the specified detail message
and nested exception.
msg
- the detail messageex
- the nested exceptionMethod Detail |
public java.lang.Throwable getCause()
public java.lang.String getMessage()
public void printStackTrace(java.io.PrintStream ps)
ps
- the print streampublic void printStackTrace(java.io.PrintWriter pw)
pw
- the print writer
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |