com.iplanet.jato
Class CompleteRequestException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--com.iplanet.jato.CompleteRequestException
All Implemented Interfaces:
java.io.Serializable

public class CompleteRequestException
extends java.lang.RuntimeException

This exception is designed to allow a developer to interrupt and complete the current request immediately, without continuing any further processing. This exception does not necessarily represent an error condition; rather, it simply means that the entity which throws the exception has decided that no further processing is required to complete the current request.

This exception is caught and silently ignored by the request processing logic in ApplicationServletBase. The request is then completed normally, including rendering of the application message buffer, RequestCompletionListener notification, and firing of the onAfterRequest event. The end user will receive the HTML document in exactly the state of readiness that had been acheived when this exception was thrown.

A common use for this exception is to redirect the current request to an error page from somewhere deep in the request processing or JSP rendering. In this situation, the developer would typically forward immediately to an error page, and when that forward returns, throw this exception to prevent the application from continuing to process the current request.

Version:
JATO/1.2.2 $Id: CompleteRequestException.java,v 1.10 2002/03/16 03:26:27 todd Exp $
See Also:
Serialized Form

Constructor Summary
CompleteRequestException()
          Default constructor
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CompleteRequestException

public CompleteRequestException()
Default constructor