Package weblogic.servlet.http

Class AbstractAsyncServlet

java.lang.Object

weblogic.servlet.http.AbstractAsyncServlet

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig, FutureResponseModel

public abstract class AbstractAsyncServlet
extends java.lang.Object
implements FutureResponseModel

Implementations of AbstractAsyncServlet decouple the receiving of a servlet request from the sending of its response. Responses may be sent in the future through the use of the notify(weblogic.servlet.http.RequestResponseKey, java.lang.Object) function. The servlet does not consume any threads while waiting for notify(weblogic.servlet.http.RequestResponseKey, java.lang.Object) to be called making it suitable for scalable proxying to remote systems. The servlet instance used for sending the response is only guaranteed to be the same as that used to process the request when SingleThreadModel is used.

Stale requests are scavanged based on timeout settings modifiable through setTimeout(int) and setScavangeInterval(int). The scavange interval is global to all AbstractAsyncServlets. The timeout period is per-servlet instance. If a timeout occurs then the doTimeout(weblogic.servlet.http.RequestResponseKey) method is called on an appropriate servlet instance, giving implementors a chance to feedback timeout information to the caller.

Only direct client requests can be used with AbstractAsyncServlet, it cannot be used as the target of request dispatching includes or forwards. It can however be used to dispatch to forwards and includes that are not instances of AbstractAsyncServlet

Servlet filters which get applied before AbstractAsyncServlets, will not be able to take advantage of post processing of the response.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_SCAVANGE_INTERVAL	The default interval period in milliseconds at which requests will be checked for timeouts.
static int	DEFAULT_TIMEOUT	The default request timeout period in milliseconds.

Method Summary

Modifier and Type	Method	Description
protected abstract boolean	doRequest(RequestResponseKey rrk)	Process the servlet request.
protected abstract void	doResponse(RequestResponseKey rrk, java.lang.Object context)	Process the servlet response.
protected abstract void	doTimeout(RequestResponseKey rrk)	Send back a servlet response error when notify(weblogic.servlet.http.RequestResponseKey, java.lang.Object) is not called within the timeout period.
static void	notify(RequestResponseKey id, java.lang.Object context)	notify the servlet implementation that a response should be sent for the key id.
protected void	service(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse rsp)	Implementation of the standard HttpServlet.service(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method.
static void	setScavangeInterval(int period)	Sets the interval period in milliseconds at which requests will be checked for timeouts.
protected void	setTimeout(int period)	Sets the request timeout period in milliseconds for this servlet.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_TIMEOUT

public static final int DEFAULT_TIMEOUT

The default request timeout period in milliseconds.

See Also:

Constant Field Values

DEFAULT_SCAVANGE_INTERVAL

public static final int DEFAULT_SCAVANGE_INTERVAL

The default interval period in milliseconds at which requests will be checked for timeouts.

See Also:

Constant Field Values

Method Detail

service

protected final void service(javax.servlet.http.HttpServletRequest req,
                             javax.servlet.http.HttpServletResponse rsp)
                      throws java.io.IOException,
                             javax.servlet.ServletException

Implementation of the standard HttpServlet.service(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) method. This method cannot be overridden, implementors should instead override doRequest(weblogic.servlet.http.RequestResponseKey) and doResponse(weblogic.servlet.http.RequestResponseKey, java.lang.Object).

Throws:

java.io.IOException

javax.servlet.ServletException

notify

public static final void notify(RequestResponseKey id,
                                java.lang.Object context)
                         throws java.io.IOException

notify the servlet implementation that a response should be sent for the key id. id must be the key provided as an argument to doRequest(weblogic.servlet.http.RequestResponseKey). Then notify> synchronously sends out the servlet response after having called doResponse(weblogic.servlet.http.RequestResponseKey, java.lang.Object). Notify will pass the context object to doResponse(weblogic.servlet.http.RequestResponseKey, java.lang.Object), if provided with one.

Parameters:

id - - the key used to identify the request/response that should be sent back.

context - - object that will be passed onto doResponse(weblogic.servlet.http.RequestResponseKey, java.lang.Object)

Throws:

java.io.IOException - - if an input or output error occurs

doRequest

protected abstract boolean doRequest(RequestResponseKey rrk)
                              throws java.io.IOException,
                                     javax.servlet.ServletException

Process the servlet request. Implementors should override this method. If a future response is to be handled, this method should return true. If a response needs to be sent immediately, this method should return false. The request and response streams are available in the RequestResponseKey.

Parameters:

rrk - the RequestResponseKey, containing the servlet request and response

Returns:

true if the response will be handled in the future.

Throws:

java.io.IOException - - if an input or output error occurs

javax.servlet.ServletException - - if the HTTP request cannot be handled

doResponse

protected abstract void doResponse(RequestResponseKey rrk,
                                   java.lang.Object context)
                            throws java.io.IOException,
                                   javax.servlet.ServletException

Process the servlet response. Implementors should override this method. There is no guarantee that the same servlet instance is used for processing doResponse as doRequest(weblogic.servlet.http.RequestResponseKey). If an exception occurs during processing then the container will arrange for the error to be sent back to the client. The request and response streams are available in the RequestResponseKey. This method may get invoked on a different thread.

Parameters:

rrk - - the RequestResponseKey, containing the servlet request and response

context - - the context object that was passed to notify(weblogic.servlet.http.RequestResponseKey, java.lang.Object)

Throws:

java.io.IOException - - if an input or output error occurs

javax.servlet.ServletException - - if the HTTP request cannot be handled

doTimeout

protected abstract void doTimeout(RequestResponseKey rrk)
                           throws java.io.IOException,
                                  javax.servlet.ServletException

Send back a servlet response error when notify(weblogic.servlet.http.RequestResponseKey, java.lang.Object) is not called within the timeout period. Implementors should override this method. There is no guarantee that the same servlet instance is used for processing doTimeout as doRequest(weblogic.servlet.http.RequestResponseKey). The request and response streams are available in the RequestResponseKey.

Parameters:

rrk - - the RequestResponseKey, containing the servlet request and response

Throws:

java.io.IOException - - if an input or output error occurs

javax.servlet.ServletException - - if the HTTP request cannot be handled

setTimeout

protected void setTimeout(int period)

Sets the request timeout period in milliseconds for this servlet. This method should typically be called from the GenericServlet.init(javax.servlet.ServletConfig) method. The new value applies only to requests started after this method call. To set the timeout for a specific servlet request, use RequestResponseKey.setTimeout(int)

Parameters:

period - the timeout period in milliseconds. A timeout period <= 0 means that requests will never be timed out.< dd>

setScavangeInterval

public static final void setScavangeInterval(int period)

Sets the interval period in milliseconds at which requests will be checked for timeouts. This setting affects all implementations of AbstractAsyncServlet.

Parameters:

period - the interval period in milliseconds. A timeout period <= 0 is illegal.< dd>