Package org.atmosphere.container

Class BlockingIOCometSupport

java.lang.Object

org.atmosphere.cpr.AsynchronousProcessor

org.atmosphere.container.BlockingIOCometSupport

All Implemented Interfaces:

AsyncSupport<AtmosphereResourceImpl>

Direct Known Subclasses:

Tomcat7BIOSupportWithWebSocket

public class BlockingIOCometSupport
extends AsynchronousProcessor

This class is used when the AtmosphereFramework fails to autodetect the Servlet Container we are running on.

This AsyncSupport implementation uses a blocking approach, meaning the request thread will be blocked until another Thread invoke the Broadcaster.broadcast(java.lang.Object).

Author:

Jeanfrancois Arcand

Field Summary

Fields

Modifier and Type	Field	Description
protected static java.lang.String	LATCH

Fields inherited from class org.atmosphere.cpr.AsynchronousProcessor

cancelledAction, config, timedoutAction

Constructor Summary

Constructors

Constructor	Description
BlockingIOCometSupport(AtmosphereConfig config)

Method Summary

Modifier and Type	Method	Description
void	action(AtmosphereResourceImpl r)	Process an Action from an ActionEvent operation like suspend, resume or timed out.
Action	cancelled(AtmosphereRequest req, AtmosphereResponse res)	All proprietary Comet based Servlet must invoke the cancelled method when the underlying WebServer detect that the client closed the connection.
AsyncSupport	complete(AtmosphereResourceImpl r)	Complete and close the connection associated with an implementation of AtmosphereResource
Action	service(AtmosphereRequest req, AtmosphereResponse res)	Serve the AtmosphereRequest and the AtmosphereResponse and return the appropriate Action.
protected void	suspend(Action action, AtmosphereRequest req, AtmosphereResponse res)	Suspend the connection by blocking the current Thread

Methods inherited from class org.atmosphere.cpr.AsynchronousProcessor

allowSessionTimeoutRemoval, completeLifecycle, endRequest, getContainerName, init, invokeAtmosphereHandler, invokeInterceptors, map, postInterceptors, resumed, shutdown, supportSession, supportWebSocket, suspended, timedout

Methods inherited from class java.lang.Object

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

Field Detail

LATCH

protected static final java.lang.String LATCH

Constructor Detail

BlockingIOCometSupport

public BlockingIOCometSupport(AtmosphereConfig config)

Method Detail

service

public Action service(AtmosphereRequest req,
                      AtmosphereResponse res)
               throws java.io.IOException,
                      javax.servlet.ServletException

Description copied from interface: AsyncSupport

Serve the AtmosphereRequest and the AtmosphereResponse and return the appropriate Action.

Parameters:

req - the AtmosphereRequest

res - the AtmosphereResponse

Returns:

the Action that was manipulated by the AtmosphereHandler

Throws:

java.io.IOException

javax.servlet.ServletException

suspend

protected void suspend(Action action,
                       AtmosphereRequest req,
                       AtmosphereResponse res)
                throws java.io.IOException,
                       javax.servlet.ServletException

Suspend the connection by blocking the current Thread

Parameters:

action - The Action

req - the AtmosphereRequest

res - the AtmosphereResponse

Throws:

java.io.IOException

javax.servlet.ServletException

cancelled

public Action cancelled(AtmosphereRequest req,
                        AtmosphereResponse res)
                 throws java.io.IOException,
                        javax.servlet.ServletException

Description copied from class: AsynchronousProcessor

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

Overrides:

cancelled in class AsynchronousProcessor

Parameters:

req - the AtmosphereRequest

res - the AtmosphereResponse

Returns:

action the Action operation.

Throws:

java.io.IOException

javax.servlet.ServletException

action

public void action(AtmosphereResourceImpl r)

Description copied from interface: AsyncSupport

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

Specified by:

action in interface AsyncSupport<AtmosphereResourceImpl>

Overrides:

action in class AsynchronousProcessor

Parameters:

r - An instance of Action

complete

public AsyncSupport complete(AtmosphereResourceImpl r)

Description copied from interface: AsyncSupport

Complete and close the connection associated with an implementation of AtmosphereResource

Specified by:

complete in interface AsyncSupport<AtmosphereResourceImpl>

Overrides:

complete in class AsynchronousProcessor

Parameters:

r - AtmosphereResource

Returns:

this