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

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by edu.utexas.its.eis.tools.qwicap.servlet.QwicapSessionDeathException
All Implemented Interfaces:
Serializable

public final class QwicapSessionDeathException
extends RuntimeException

QwicapSessionDeathException is thrown when a Qwicap application must quit. There are two common reasons: one of the Qwicap.goodbye methods has been invoked, or the session has timed-out. The session timeout is the amount of time a web application is allowed to live without having any interaction with its user. When the timeout is reached, it is assumed that the user has abandoned (ceased to use) the application, and that the application should exit in order to release the resources it holds. Once the timeout has occurred, the current Qwicap.prompt method invocation throws this exception and the application is meant to conduct a graceful exit. At this point, any number of Qwicap methods will also throw the QwicapSessionDeathException, since they no longer have a valid function to perform, and to prevent the application from doing things that would impede it from exiting, like accidentally going back into a page processing loop. The timeout is set in the "web-app/session-config/session-timeout" tag of the web application's "web.xml" file.

Author:
Chris W. Johnson
See Also:
Serialized Form

Method Summary
 
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