org.atmosphere.interceptor

Class AtmosphereResourceLifecycleInterceptor

java.lang.Object

org.atmosphere.interceptor.AtmosphereResourceLifecycleInterceptor

All Implemented Interfaces:

AtmosphereInterceptor

public class AtmosphereResourceLifecycleInterceptor
extends Object
implements AtmosphereInterceptor

This AtmosphereInterceptor implementation automatically suspends the intercepted AtmosphereResource and takes care of managing the response's state (flushing, resuming, etc.) when a Broadcaster.broadcast(java.lang.Object) is invoked. When used, AtmosphereHandler implementations no longer need to make calls to AtmosphereResource.suspend().

If your application doesn't use Broadcaster, this interceptor will not work and you need to programmatically resume, flush, etc.

By default, intercepted AtmosphereResource instances are suspended when a GET request is received. You can change the triggering http method by configuring ApplicationConfig.ATMOSPHERERESOURCE_INTERCEPTOR_METHOD

Use this class when you don't want to manage the suspend/resume operation from your particular Atmosphere framework implementation classes (AtmosphereHandler, WebSocketHandler, or Meteor instances) or extensions (GWT, Jersey, Wicket, etc...)

For this mechanism to work properly, each client must set the HeaderConfig.X_ATMOSPHERE_TRANSPORT header. Your AtmosphereHandler must also extends the AbstractReflectorAtmosphereHandler or implements the logic defined inside AbstractReflectorAtmosphereHandler.postStateChange(org.atmosphere.cpr.AtmosphereResourceEvent)

Author:

Jeanfrancois Arcand

Constructor Summary

Constructors

Constructor and Description
AtmosphereResourceLifecycleInterceptor()
AtmosphereResourceLifecycleInterceptor(boolean force)

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(AtmosphereConfig config) Allow this object to configure its state when initialized.
Action	inspect(AtmosphereResource r) Automatically suspend the AtmosphereResource based on AtmosphereResource.TRANSPORT value.
void	postInspect(AtmosphereResource r) Invoked after an AtmosphereResource gets dispatched to AtmosphereHandler.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AtmosphereResourceLifecycleInterceptor

public AtmosphereResourceLifecycleInterceptor()

AtmosphereResourceLifecycleInterceptor

public AtmosphereResourceLifecycleInterceptor(boolean force)

Method Detail

configure

public void configure(AtmosphereConfig config)

Description copied from interface: AtmosphereInterceptor

Allow this object to configure its state when initialized.

Specified by:

configure in interface AtmosphereInterceptor

Parameters:

config - an AtmosphereConfig

inspect

public Action inspect(AtmosphereResource r)

Automatically suspend the AtmosphereResource based on AtmosphereResource.TRANSPORT value.

Specified by:

inspect in interface AtmosphereInterceptor

Parameters:

r - a AtmosphereResource

Returns:

postInspect

public void postInspect(AtmosphereResource r)

Description copied from interface: AtmosphereInterceptor

Invoked after an AtmosphereResource gets dispatched to AtmosphereHandler.

Specified by:

postInspect in interface AtmosphereInterceptor

Parameters:

r - a AtmosphereResource

toString

public String toString()

Overrides:

toString in class Object