JspException (Java 2 Platform Ent. Ed. v1.4)

Overview

Package

Class

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Ent. Ed. v1.4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES All Classes

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.servlet.jsp
Class JspException

java.lang.Object
 extended byjava.lang.Throwable
 extended byjava.lang.Exception
 extended byjavax.servlet.jsp.JspException

All Implemented Interfaces:: Serializable

Direct Known Subclasses:: JspTagException, SkipPageException

public class JspException
extends Exception

A generic exception known to the JSP engine; uncaught JspExceptions will result in an invocation of the errorpage machinery.

See Also:: Serialized Form

Constructor Summary
`JspException()` Construct a JspException.
`JspException(String msg)` Constructs a new JSP exception with the specified message.
`JspException(String message, Throwable rootCause)` Constructs a new JSP exception when the JSP needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation, including a description message.
`JspException(Throwable rootCause)` Constructs a new JSP exception when the JSP needs to throw an exception and include a message about the "root cause" exception that interfered with its normal operation.

Method Summary
`Throwable`	`getRootCause()` Returns the exception that caused this JSP 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

Constructor Detail

JspException

public JspException()

Construct a JspException.

JspException

public JspException(String msg)

Constructs a new JSP exception with the specified message. The message can be written to the server log and/or displayed for the user.
Parameters:: msg - a String specifying the text of the exception message

JspException

public JspException(String message,
 Throwable rootCause)

Constructs a new JSP exception when the JSP 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 - a String containing the text of the exception message; rootCause - the Throwable exception that interfered with the servlet's normal operation, making this servlet exception necessary

JspException

public JspException(Throwable rootCause)

Constructs a new JSP exception when the JSP 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 JspException, this method can be overridden to create an exception message designed for a specific locale.

Parameters:

rootCause - the Throwable exception that interfered with the JSP's normal operation, making the JSP exception necessary

Method Detail