- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.servlet.ServletException
-
- All Implemented Interfaces:
- Serializable
- Direct Known Subclasses:
- UnavailableException
public class ServletException extends Exception
Defines a general exception a servlet can throw when it encounters difficulty.- Author:
- Various
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description ServletException()Constructs a new servlet exception.ServletException(String message)Constructs a new servlet exception with the specified message.ServletException(String message, 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(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
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description ThrowablegetRootCause()Returns the exception that caused this servlet exception.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
ServletException
public ServletException()
Constructs a new servlet exception.
-
ServletException
public ServletException(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.- Parameters:
message- aStringspecifying the text of the exception message
-
ServletException
public ServletException(String message, 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.- Parameters:
message- aStringcontaining the text of the exception messagerootCause- theThrowableexception that interfered with the servlet's normal operation, making this servlet exception necessary
-
ServletException
public ServletException(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
getLocalizedMessagemethod on theThrowableexception to get a localized exception message. When subclassingServletException, this method can be overridden to create an exception message designed for a specific locale.- Parameters:
rootCause- theThrowableexception that interfered with the servlet's normal operation, making the servlet exception necessary
-
-
Method Detail
-
getRootCause
public Throwable getRootCause()
Returns the exception that caused this servlet exception.- Returns:
- the
Throwablethat caused this servlet exception
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/servlet/ServletException.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.