Class JspTagException
java.lang.Object
java.lang.Throwable
java.lang.Exception
jakarta.servlet.jsp.JspException
jakarta.servlet.jsp.JspTagException
- All Implemented Interfaces:
Serializable
Exception to be used by a Tag Handler to indicate some unrecoverable error. This error is to be caught by the top
level of the JSP page and will result in an error page.
- See Also:
-
Constructor Summary
ConstructorDescriptionConstructs a new JspTagException with no message.JspTagException
(String msg) Constructs a new JspTagException with the specified message.JspTagException
(String message, Throwable rootCause) Constructs a new JspTagException when the JSP Tag needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation, including a description message.JspTagException
(Throwable rootCause) Constructs a new JSP Tag exception when the JSP Tag needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation. -
Method Summary
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
JspTagException
Constructs a new JspTagException with the specified message. The message can be written to the server log and/or displayed for the user.- Parameters:
msg
- aString
specifying the text of the exception message
-
JspTagException
public JspTagException()Constructs a new JspTagException with no message. -
JspTagException
Constructs a new JspTagException when the JSP Tag 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
- aString
containing the text of the exception messagerootCause
- theThrowable
exception that interfered with the JSP Tag's normal operation, making this JSP Tag exception necessary- Since:
- JSP 2.0
-
JspTagException
Constructs a new JSP Tag exception when the JSP Tag 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 theThrowable
exception to get a localized exception message. When subclassingJspTagException
, this method can be overridden to create an exception message designed for a specific locale.- Parameters:
rootCause
- theThrowable
exception that interfered with the JSP Tag's normal operation, making the JSP Tag exception necessary- Since:
- JSP 2.0
-