Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

javax.servlet
Class ServletException  view ServletException download ServletException.java

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjavax.servlet.ServletException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
UnavailableException

public class ServletException
extends java.lang.Exception

Defines a general exception a servlet can throw when it encounters difficulty.

Version:
$Version$

Nested Class Summary
 
Nested classes inherited from class java.lang.Throwable
 
Field Summary
private  java.lang.Throwable rootCause
           
 
Fields inherited from class java.lang.Exception
 
Fields inherited from class java.lang.Throwable
 
Constructor Summary
ServletException()
          Constructs a new servlet exception.
ServletException(java.lang.String message)
          Constructs a new servlet exception with the specified message.
ServletException(java.lang.String message, java.lang.Throwable rootCause)
          Constructs a new servlet exception when the servlet needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation, including a description message.
ServletException(java.lang.Throwable rootCause)
          Constructs a new servlet exception when the servlet needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation.
 
Method Summary
 java.lang.Throwable getRootCause()
          Returns the exception that caused this servlet exception.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

rootCause

private java.lang.Throwable rootCause
Constructor Detail

ServletException

public ServletException()
Constructs a new servlet exception.


ServletException

public ServletException(java.lang.String message)
Constructs a new servlet exception with the specified message. The message can be written to the server log and/or displayed for the user.


ServletException

public ServletException(java.lang.String message,
                        java.lang.Throwable rootCause)
Constructs a new servlet exception when the servlet needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation, including a description message.


ServletException

public ServletException(java.lang.Throwable rootCause)
Constructs a new servlet exception when the servlet needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation. The exception's message is based on the localized message of the underlying exception.

This method calls the getLocalizedMessage method on the Throwable exception to get a localized exception message. When subclassing ServletException, this method can be overridden to create an exception message designed for a specific locale.

Method Detail

getRootCause

public java.lang.Throwable getRootCause()
Returns the exception that caused this servlet exception.