edu.utexas.its.eis.tools.qwicap.servlet
Class QwicapAbandonmentException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          edu.utexas.its.eis.tools.qwicap.servlet.QwicapException
              edu.utexas.its.eis.tools.qwicap.servlet.QwicapAbandonmentException

All Implemented Interfaces:

Serializable

public abstract class QwicapAbandonmentException
extends QwicapException

Subclasses of QwicapAbandonmentException are thrown in response to user abandonment of web pages, forms on a web page, or invalid input to a form. Client code should handle all of these exceptions by catching only QwicapAbandonmentException, and handling it as described in the Qwicap Prompt Pattern. Therefore, the subclasses have package-level access only, so clients can't make the mistake of attempting to handle them individually (at least, not without working at it).

Author:

Chris W. Johnson

See Also:

Serialized Form

Constructor Summary

protected	QwicapAbandonmentException(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo, boolean EvaluateNewInput)
protected	QwicapAbandonmentException(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo, boolean EvaluateNewInput, String Message)
protected	QwicapAbandonmentException(String CauseOfDeathMsg)

Method Summary

void	rethrowIfThisPageWasAbandoned() Rethrows the QwicapPageAbandonedException if, and only if, the caller represents one of the pages that has been abandoned by the user.
static void	rethrowIfThisPageWasAbandoned(Throwable T) Examines an arbitrary Throwable and all of its causes to determine if any of them were of type QwicapPageAbandonedException, and, if so, it rethrows the QwicapPageAbandonedException if, and only if, the caller represents one of the pages that has been abandoned by the user.
protected edu.utexas.its.eis.tools.qwicap.servlet.Page	setNoPromptPage(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo, boolean EvaluateNewInput)

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

QwicapAbandonmentException

protected QwicapAbandonmentException(String CauseOfDeathMsg)

QwicapAbandonmentException

protected QwicapAbandonmentException(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo,
                                     boolean EvaluateNewInput)

QwicapAbandonmentException

protected QwicapAbandonmentException(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo,
                                     boolean EvaluateNewInput,
                                     String Message)

Method Detail

setNoPromptPage

protected edu.utexas.its.eis.tools.qwicap.servlet.Page setNoPromptPage(edu.utexas.its.eis.tools.qwicap.servlet.Page PageToRevertTo,
                                                                       boolean EvaluateNewInput)

rethrowIfThisPageWasAbandoned

public void rethrowIfThisPageWasAbandoned()
                                   throws QwicapAbandonmentException

Rethrows the QwicapPageAbandonedException if, and only if, the caller represents one of the pages that has been abandoned by the user.

Throws:

QwicapPageAbandonedException - If the caller representes one of the pages that has been abandoned by the user.

QwicapAbandonmentException

rethrowIfThisPageWasAbandoned

public static void rethrowIfThisPageWasAbandoned(Throwable T)
                                          throws QwicapAbandonmentException

Examines an arbitrary Throwable and all of its causes to determine if any of them were of type QwicapPageAbandonedException, and, if so, it rethrows the QwicapPageAbandonedException if, and only if, the caller represents one of the pages that has been abandoned by the user.

Parameters:

T - A Throwable that might be, or have been caused by, a QwicapPageAbandonedException.

Throws:

QwicapPageAbandonedException - If the supplied Throwable, or any of its causes, was a QwicapPageAbandonedException, and that exception's rethrowIfThisPageWasAbandoned method believes that caller's page was among those abandoned by the user.

QwicapAbandonmentException