Spring Framework

org.springframework.web.util
Class NestedServletException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by javax.servlet.ServletException
              extended by org.springframework.web.util.NestedServletException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
ServletRequestBindingException

public class NestedServletException
extends javax.servlet.ServletException

Subclass of ServletException that properly handles a root cause in terms of message and stacktrace, just like NestedChecked/RuntimeException does.

Note that the plain ServletException doesn't expose its root cause at all, neither in the exception message nor in printed stack traces! While this might be fixed in later Servlet API variants (which even differ per vendor for the same API version), it is not reliably available on Servlet 2.4 (the minimum version required by Spring 3.x), which is why we need to do it ourselves.

The similarity between this class and the NestedChecked/RuntimeException class is unavoidable, as this class needs to derive from ServletException.

Since:
1.2.5
Author:
Juergen Hoeller
See Also:
getMessage(), Throwable.printStackTrace(), NestedCheckedException, NestedRuntimeException, Serialized Form

Constructor Summary
NestedServletException(java.lang.String msg)
          Construct a NestedServletException with the specified detail message.
NestedServletException(java.lang.String msg, java.lang.Throwable cause)
          Construct a NestedServletException with the specified detail message and nested exception.
 
Method Summary
 java.lang.String getMessage()
          Return the detail message, including the message from the nested exception if there is one.
 
Methods inherited from class javax.servlet.ServletException
getRootCause
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

NestedServletException

public NestedServletException(java.lang.String msg)
Construct a NestedServletException with the specified detail message.

Parameters:
msg - the detail message

NestedServletException

public NestedServletException(java.lang.String msg,
                              java.lang.Throwable cause)
Construct a NestedServletException with the specified detail message and nested exception.

Parameters:
msg - the detail message
cause - the nested exception
Method Detail

getMessage

public java.lang.String getMessage()
Return the detail message, including the message from the nested exception if there is one.

Overrides:
getMessage in class java.lang.Throwable

Spring Framework