org.atmosphere.cpr
Class AsynchronousProcessor

java.lang.Object
  org.atmosphere.cpr.AsynchronousProcessor

All Implemented Interfaces:

CometSupport<AtmosphereResourceImpl>

Direct Known Subclasses:

BlockingIOCometSupport, GlassFishv2CometSupport, GrizzlyCometSupport, JBossWebCometSupport, Jetty7CometSupport, JettyCometSupport, Servlet30Support, TomcatCometSupport, WebLogicCometSupport

public abstract class AsynchronousProcessor
extends Object
implements CometSupport<AtmosphereResourceImpl>

Base class which implement the semantics of suspending and resuming of a Comet Request.

Author:

Jeanfrancois Arcand

Field Summary

protected ConcurrentHashMap<HttpServletRequest,AtmosphereResource<HttpServletRequest,HttpServletResponse>>	aliveRequests
protected static AtmosphereServlet.Action	cancelledAction
protected AtmosphereServlet.AtmosphereConfig	config
protected Logger	logger
protected static AtmosphereServlet.Action	timedoutAction

Fields inherited from interface org.atmosphere.cpr.CometSupport

MAX_INACTIVE

Constructor Summary

AsynchronousProcessor(AtmosphereServlet.AtmosphereConfig config)

Method Summary

void	action(AtmosphereResourceImpl r) Process an AtmosphereServlet.Action from an ActionEvent operation like suspend, resume or timed out.
AtmosphereServlet.Action	cancelled(HttpServletRequest req, HttpServletResponse res) All proprietary Comet based Servlet must invoke the cancelled method when the underlying WebServer detect that the client closed the connection.
String	getContainerName() Return the container's name.
void	init(ServletConfig sc) Initialize the WebServer using the ServletConfig
protected AtmosphereServlet.AtmosphereHandlerWrapper	map(HttpServletRequest req) Return the AtmosphereHandler mapped to the passed servlet-path.
AtmosphereServlet.Action	resumed(HttpServletRequest req, HttpServletResponse res) All proprietary Comet based Servlet must invoke the resume method when the Atmosphere's application decide to resume the HttpServletResponse.
protected boolean	supportSession() Is HttpSession supported
boolean	supportWebSocket() Return true if this implementation supports the websocket protocol.
AtmosphereServlet.Action	suspended(HttpServletRequest req, HttpServletResponse res) All proprietary Comet based Servlet must invoke the suspended method when the first request comes in.
AtmosphereServlet.Action	timedout(HttpServletRequest req, HttpServletResponse res) All proprietary Comet based Servlet must invoke the timedout method when the underlying WebServer time out the HttpServletResponse.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.atmosphere.cpr.CometSupport

service

Field Detail

timedoutAction

protected static final AtmosphereServlet.Action timedoutAction

cancelledAction

protected static final AtmosphereServlet.Action cancelledAction

logger

protected final Logger logger

config

protected final AtmosphereServlet.AtmosphereConfig config

aliveRequests

protected final ConcurrentHashMap<HttpServletRequest,AtmosphereResource<HttpServletRequest,HttpServletResponse>> aliveRequests

Constructor Detail

AsynchronousProcessor

public AsynchronousProcessor(AtmosphereServlet.AtmosphereConfig config)

Method Detail

init

public void init(ServletConfig sc)
          throws ServletException

Description copied from interface: CometSupport

Initialize the WebServer using the ServletConfig

Specified by:

init in interface CometSupport<AtmosphereResourceImpl>

Parameters:

sc - the ServletConfig

Throws:

ServletException

supportSession

protected boolean supportSession()

Is HttpSession supported

Returns:

true if supported

getContainerName

public String getContainerName()

Return the container's name.

Specified by:

getContainerName in interface CometSupport<AtmosphereResourceImpl>

Returns:

the name of the Java Web Server.

suspended

public AtmosphereServlet.Action suspended(HttpServletRequest req,
                                          HttpServletResponse res)
                                   throws IOException,
                                          ServletException

All proprietary Comet based Servlet must invoke the suspended method when the first request comes in. The returned value, of type AtmosphereServlet.Action, tells the proprietary Comet Servlet to suspended or not the current HttpServletResponse.

Parameters:

req - the HttpServletRequest

res - the HttpServletResponse

Returns:

action the Action operation.

Throws:

IOException

ServletException

action

public void action(AtmosphereResourceImpl r)

Process an AtmosphereServlet.Action from an ActionEvent operation like suspend, resume or timed out.

Specified by:

action in interface CometSupport<AtmosphereResourceImpl>

Parameters:

r - An instance of AtmosphereServlet.Action

map

protected AtmosphereServlet.AtmosphereHandlerWrapper map(HttpServletRequest req)
                                                  throws ServletException

Return the AtmosphereHandler mapped to the passed servlet-path.

Parameters:

req - the HttpServletResponse

Returns:

the AtmosphereHandler mapped to the passed servlet-path.

Throws:

ServletException

resumed

public AtmosphereServlet.Action resumed(HttpServletRequest req,
                                        HttpServletResponse res)
                                 throws IOException,
                                        ServletException

All proprietary Comet based Servlet must invoke the resume method when the Atmosphere's application decide to resume the HttpServletResponse. The returned value, of type AtmosphereServlet.Action, tells the proprietary Comet Servlet to resume (again), suspended or do nothing with the current HttpServletResponse.

Parameters:

req - the HttpServletRequest

res - the HttpServletResponse

Returns:

action the Action operation.

Throws:

IOException

ServletException

timedout

public AtmosphereServlet.Action timedout(HttpServletRequest req,
                                         HttpServletResponse res)
                                  throws IOException,
                                         ServletException

All proprietary Comet based Servlet must invoke the timedout method when the underlying WebServer time out the HttpServletResponse. The returned value, of type AtmosphereServlet.Action, tells the proprietary Comet Servlet to resume (again), suspended or do nothing with the current HttpServletResponse.

Parameters:

req - the HttpServletRequest

res - the HttpServletResponse

Returns:

action the Action operation.

Throws:

IOException

ServletException

cancelled

public AtmosphereServlet.Action cancelled(HttpServletRequest req,
                                          HttpServletResponse res)
                                   throws IOException,
                                          ServletException

All proprietary Comet based Servlet must invoke the cancelled method when the underlying WebServer detect that the client closed the connection.

Parameters:

req - the HttpServletRequest

res - the HttpServletResponse

Returns:

action the Action operation.

Throws:

IOException

ServletException

supportWebSocket

public boolean supportWebSocket()

Description copied from interface: CometSupport

Return true if this implementation supports the websocket protocol. return true if supported

Specified by:

supportWebSocket in interface CometSupport<AtmosphereResourceImpl>