org.atmosphere.cpr
Class AtmosphereResourceImpl

java.lang.Object
  org.atmosphere.cpr.AtmosphereResourceImpl

All Implemented Interfaces:

AtmosphereEventLifecycle, AtmosphereResource, Trackable

public class AtmosphereResourceImpl
extends Object
implements AtmosphereResource

AtmosphereResource implementation for supporting AtmosphereRequest and AtmosphereRequest.

Author:

Jeanfrancois Arcand

Nested Class Summary

Nested classes/interfaces inherited from interface org.atmosphere.cpr.AtmosphereResource

AtmosphereResource.TRANSPORT

Field Summary

protected AtmosphereFramework.Action	action
protected AsyncSupport	asyncSupport
protected Broadcaster	broadcaster
static String	METEOR
static String	PRE_SUSPEND
static String	SKIP_BROADCASTER_CREATION

Constructor Summary

AtmosphereResourceImpl(AtmosphereConfig config, Broadcaster broadcaster, AtmosphereRequest req, AtmosphereResponse response, AsyncSupport asyncSupport, AtmosphereHandler atmosphereHandler)
Create an AtmosphereResource.

Method Summary

AtmosphereFramework.Action	action() Return the AtmosphereFramework.Action which represent the state of the response, e.g.
void	addEventListener(AtmosphereResourceEventListener e) Add a AtmosphereResourceEventListener.
ConcurrentLinkedQueue<AtmosphereResourceEventListener>	atmosphereResourceEventListener()
void	cancel()
static String	createStreamingPadding(String padding) Output message when Atmosphere suspend a connection.
boolean	equals(Object o)
AtmosphereConfig	getAtmosphereConfig() Return the AtmosphereConfig
AtmosphereHandler	getAtmosphereHandler() Return the associated AtmosphereHandler associated with this resource.
AtmosphereResourceEventImpl	getAtmosphereResourceEvent() Return the current AtmosphereResourceEvent.
Broadcaster	getBroadcaster() Return the current Broadcaster
protected Broadcaster	getBroadcaster(boolean autoCreate)
AtmosphereRequest	getRequest() Return the underlying AtmosphereRequest Request.
AtmosphereRequest	getRequest(boolean enforceScope)
AtmosphereResponse	getResponse() Return the AtmosphereResponse
AtmosphereResponse	getResponse(boolean enforceScope)
Serializer	getSerializer() Get the Serializer or null if not defined.
int	hashCode()
boolean	isCancelled() Return true if this object has been cancelled.
boolean	isInScope() Is the AtmosphereRequest still valid.
boolean	isResumed() Return true if this object has been resumed.
boolean	isSuspended() Return true is the AtmosphereResource.suspend() has been invoked.
void	notifyListeners() Notify AtmosphereResourceEventListener.
void	notifyListeners(AtmosphereResourceEvent event) Notify AtmosphereResourceEventListener.
void	onThrowable(Throwable t) Notify AtmosphereResourceEventListener an unexpected exception occured.\
void	removeEventListener(AtmosphereResourceEventListener e) Add a AtmosphereResourceEventListener.
void	removeEventListeners() Remove all AtmosphereResourceEventListener.
AtmosphereResource	resume() Complete the AtmosphereResponse and finish/commit it.
boolean	resumeOnBroadcast() Return the is the AtmosphereResource.resumeOnBroadcast()
AtmosphereResource	resumeOnBroadcast(boolean resumeOnBroadcast) Set to true to resume the response once after the first broadcast.
AtmosphereResource	setBroadcaster(Broadcaster broadcaster) Set the current Broadcaster.
void	setIsInScope(boolean isInScope) Protect the object for being used after it got cancelled.
AtmosphereResource	setSerializer(Serializer s) Set the Serializer used to write broadcasted object.
AtmosphereResource	suspend() Suspend the AtmosphereResponse indefinitely.
AtmosphereResource	suspend(long timeout) Suspend the AtmosphereResponse.
AtmosphereResource	suspend(long timeout, boolean flushComment) Suspend the AtmosphereResponse.
AtmosphereResource	suspend(long timeout, TimeUnit timeunit) Suspend the AtmosphereResponse.
AtmosphereResource	suspend(long timeout, TimeUnit timeunit, boolean flushComment) Suspend the AtmosphereResponse.
String	toString()
AtmosphereResource.TRANSPORT	transport() Return the current AtmosphereResource.TRANSPORT.
AtmosphereResource	write(OutputStream os, Object o) Write the broadcasted object using the OutputStream.
Object	writeOnTimeout() Return the object that will be written when the resource times out;
AtmosphereResource	writeOnTimeout(Object o) Set a message that will be written when the resource times out.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

PRE_SUSPEND

public static final String PRE_SUSPEND

SKIP_BROADCASTER_CREATION

public static final String SKIP_BROADCASTER_CREATION

METEOR

public static final String METEOR

action

protected final AtmosphereFramework.Action action

broadcaster

protected Broadcaster broadcaster

asyncSupport

protected final AsyncSupport asyncSupport

Constructor Detail

AtmosphereResourceImpl

public AtmosphereResourceImpl(AtmosphereConfig config,
                              Broadcaster broadcaster,
                              AtmosphereRequest req,
                              AtmosphereResponse response,
                              AsyncSupport asyncSupport,
                              AtmosphereHandler atmosphereHandler)

Create an AtmosphereResource.

Parameters:

config - The AtmosphereConfig

broadcaster - The Broadcaster.

req - The AtmosphereRequest

response - The AtmosphereResource

asyncSupport - The AsyncSupport

atmosphereHandler - The AtmosphereHandler

Method Detail

getAtmosphereResourceEvent

public AtmosphereResourceEventImpl getAtmosphereResourceEvent()

Return the current AtmosphereResourceEvent.

Specified by:

getAtmosphereResourceEvent in interface AtmosphereResource

getAtmosphereHandler

public AtmosphereHandler getAtmosphereHandler()

Return the associated AtmosphereHandler associated with this resource.

Specified by:

getAtmosphereHandler in interface AtmosphereResource

Returns:

the associated AtmosphereHandler associated with this resource.

writeOnTimeout

public AtmosphereResource writeOnTimeout(Object o)

Set a message that will be written when the resource times out. Cab be an Object or Callable

Specified by:

writeOnTimeout in interface AtmosphereResource

writeOnTimeout

public Object writeOnTimeout()

Return the object that will be written when the resource times out;

Specified by:

writeOnTimeout in interface AtmosphereResource

transport

public AtmosphereResource.TRANSPORT transport()

Return the current AtmosphereResource.TRANSPORT. The transport value is retrieved using the HeaderConfig.X_ATMOSPHERE_TRANSPORT header value.

Specified by:

transport in interface AtmosphereResource

resumeOnBroadcast

public AtmosphereResource resumeOnBroadcast(boolean resumeOnBroadcast)

Set to true to resume the response once after the first broadcast. False by default.

Specified by:

resumeOnBroadcast in interface AtmosphereResource

isSuspended

public boolean isSuspended()

Return true is the AtmosphereResource.suspend() has been invoked.

Specified by:

isSuspended in interface AtmosphereResource

Returns:

true is the AtmosphereResource.suspend() has been invoked.

resumeOnBroadcast

public boolean resumeOnBroadcast()

Return the is the AtmosphereResource.resumeOnBroadcast()

Specified by:

resumeOnBroadcast in interface AtmosphereResource

resume

public AtmosphereResource resume()

Complete the AtmosphereResponse and finish/commit it. If the AtmosphereResponse is in the process of being resumed, invoking that method has no effect.

Specified by:

resume in interface AtmosphereResource

suspend

public AtmosphereResource suspend()

Suspend the AtmosphereResponse indefinitely. Suspending a AtmosphereResponse will tell the underlying container to avoid recycling objects associated with the current instance, and also to avoid commiting response.

The Framework will output some HTML comments when suspending the response in order to make sure all Browser works well with suspended response.

Specified by:

suspend in interface AtmosphereResource

suspend

public AtmosphereResource suspend(long timeout)

Suspend the AtmosphereResponse. Suspending a AtmosphereResponse will tell the underlying container to avoid recycling objects associated with the current instance, and also to avoid commiting response. Invoking this method when a request is being timed out, e.g. AtmosphereResourceEvent.isResumedOnTimeout() return true, has no effect.

The Framework will output some HTML comments when suspending the response in order to make sure all Browser works well with suspended response. By default, the AtmosphereResponse.getWriter() will be used. You can change that behavior by setting a request attribute named org.atmosphere.useStream to so the framework will use AtmosphereResponse.getOutputStream()

Specified by:

suspend in interface AtmosphereResource

Parameters:

timeout - The maximum amount of time, in milliseconds, a AtmosphereResponse can be suspended. When the timeout expires (because nothing has been written or because the AtmosphereResource.resume() , the AtmosphereResponse will be automatically resumed and commited. Usage of any methods of a AtmosphereResponse that times out will throw an IllegalStateException.

suspend

public AtmosphereResource suspend(long timeout,
                                  TimeUnit timeunit)

Suspend the AtmosphereResponse. Suspending a AtmosphereResponse will tell the underlying container to avoid recycling objects associated with the current instance, and also to avoid commiting response. Invoking this method when a request is being timed out, e.g. AtmosphereResourceEvent.isResumedOnTimeout() return true, has no effect.

The Framework will output some HTML comments when suspending the response in order to make sure all Browser works well with suspended response. By default, the AtmosphereResponse.getWriter() will be used. You can change that behavior by setting a request attribute named org.atmosphere.useStream to so the framework will use AtmosphereResponse.getOutputStream()

Specified by:

suspend in interface AtmosphereResource

Parameters:

timeout - The maximum amount of time, a AtmosphereResponse can be suspended. When the timeout expires (because nothing has been written or because the AtmosphereResource.resume() , the AtmosphereResponse will be automatically resumed and commited. Usage of any methods of a AtmosphereResponse that times out will throw an IllegalStateException.

timeunit - The time unit of the timeout value

suspend

public AtmosphereResource suspend(long timeout,
                                  TimeUnit timeunit,
                                  boolean flushComment)

Suspend the AtmosphereResponse. Suspending a AtmosphereResponse will tell the underlying container to avoid recycling objects associated with the current instance, and also to avoid commiting response. Invoking this method when a request is being timed out, e.g. AtmosphereResourceEvent.isResumedOnTimeout() return true, has no effect.

The Framework will output some HTML comments when suspending the response in order to make sure all Browser works well with suspended response. By default, the AtmosphereResponse.getWriter() will be used. You can change that behavior by setting a request attribute named org.atmosphere.useStream to so the framework will use AtmosphereResponse.getOutputStream()

Specified by:

suspend in interface AtmosphereResource

Parameters:

timeout - The maximum amount of time, in milliseconds, a AtmosphereResponse can be suspended. When the timeout expires (because nothing has been written or because the AtmosphereResource.resume() , the AtmosphereResponse will be automatically resumed and commited. Usage of any methods of a AtmosphereResponse that times out will throw an IllegalStateException.

timeunit - The time unit of the timeout value

flushComment - By default, Atmosphere will output some comments to make WebKit based browser working. Set it to false if you want to remove it.

suspend

public AtmosphereResource suspend(long timeout,
                                  boolean flushComment)

Description copied from interface: AtmosphereResource

Suspend the AtmosphereResponse. Suspending a AtmosphereResponse will tell the underlying container to avoid recycling objects associated with the current instance, and also to avoid commiting response. Invoking this method when a request is being timed out, e.g. AtmosphereResourceEvent.isResumedOnTimeout() return true, has no effect.

The Framework will output some HTML comments when suspending the response in order to make sure all Browser works well with suspended response. By default, the AtmosphereResponse.getWriter() will be used. You can change that behavior by setting a request attribute named org.atmosphere.useStream to so the framework will use AtmosphereResponse.getOutputStream()

Specified by:

suspend in interface AtmosphereResource

Parameters:

timeout - The maximum amount of time, in milliseconds, a AtmosphereResponse can be suspended. When the timeout expires (because nothing has been written or because the AtmosphereResource.resume() , the AtmosphereResponse will be automatically resumed and commited. Usage of any methods of a AtmosphereResponse that times out will throw an IllegalStateException.

flushComment - By default, Atmosphere will output some comments to make WebKit based browser working. Set it to false if you want to remove it.

getRequest

public AtmosphereRequest getRequest(boolean enforceScope)

getResponse

public AtmosphereResponse getResponse(boolean enforceScope)

getRequest

public AtmosphereRequest getRequest()

Return the underlying AtmosphereRequest Request.

Specified by:

getRequest in interface AtmosphereResource

Returns:

AtmosphereRequest the underlying Request.

getResponse

public AtmosphereResponse getResponse()

Return the AtmosphereResponse

Specified by:

getResponse in interface AtmosphereResource

Returns:

AtmosphereResponse the underlying Response.

getBroadcaster

public Broadcaster getBroadcaster()

Return the current Broadcaster

Specified by:

getBroadcaster in interface AtmosphereResource

Returns:

the current Broadcaster

getBroadcaster

protected Broadcaster getBroadcaster(boolean autoCreate)

setBroadcaster

public AtmosphereResource setBroadcaster(Broadcaster broadcaster)

Set the current Broadcaster. If null, a new Broadcaster will be created with Broadcaster.SCOPE.REQUEST will be created if that resource hasn't been yet suspended.

Specified by:

setBroadcaster in interface AtmosphereResource

getAtmosphereConfig

public AtmosphereConfig getAtmosphereConfig()

Return the AtmosphereConfig

Specified by:

getAtmosphereConfig in interface AtmosphereResource

Returns:

the AtmosphereConfig

action

public AtmosphereFramework.Action action()

Return the AtmosphereFramework.Action which represent the state of the response, e.g. suspended, resumed or timedout.

Returns:

the AtmosphereFramework.Action

setIsInScope

public void setIsInScope(boolean isInScope)

Protect the object for being used after it got cancelled.

Parameters:

isInScope -

isInScope

public boolean isInScope()

Is the AtmosphereRequest still valid.

Returns:

true if the AtmosphereRequest still valid

setSerializer

public AtmosphereResource setSerializer(Serializer s)

Set the Serializer used to write broadcasted object.

Specified by:

setSerializer in interface AtmosphereResource

Parameters:

s -

isResumed

public boolean isResumed()

Return true if this object has been resumed.

Specified by:

isResumed in interface AtmosphereResource

Returns:

true if this object has been resumed.

isCancelled

public boolean isCancelled()

Return true if this object has been cancelled.

Specified by:

isCancelled in interface AtmosphereResource

Returns:

true if this object has been cancelled.

write

public AtmosphereResource write(OutputStream os,
                                Object o)
                         throws IOException

Write the broadcasted object using the OutputStream. If a Serializer is defined, the operation will be delagated to it. If not, the (Response) OutputStream will be used by calling Object.toString.getBytes()

Specified by:

write in interface AtmosphereResource

Parameters:

os - an OutputStream

o - an Object

Throws:

IOException

getSerializer

public Serializer getSerializer()

Get the Serializer or null if not defined.

Specified by:

getSerializer in interface AtmosphereResource

Returns:

the Serializer or null if not defined.

createStreamingPadding

public static String createStreamingPadding(String padding)

Output message when Atmosphere suspend a connection.

Returns:

message when Atmosphere suspend a connection.

addEventListener

public void addEventListener(AtmosphereResourceEventListener e)

Add a AtmosphereResourceEventListener.

Specified by:

addEventListener in interface AtmosphereEventLifecycle

Parameters:

e - an instance of AtmosphereResourceEventListener

removeEventListener

public void removeEventListener(AtmosphereResourceEventListener e)

Add a AtmosphereResourceEventListener.

Specified by:

removeEventListener in interface AtmosphereEventLifecycle

Parameters:

e - an instance of AtmosphereResourceEventListener

removeEventListeners

public void removeEventListeners()

Remove all AtmosphereResourceEventListener.

Specified by:

removeEventListeners in interface AtmosphereEventLifecycle

notifyListeners

public void notifyListeners()

Notify AtmosphereResourceEventListener.

Specified by:

notifyListeners in interface AtmosphereEventLifecycle

notifyListeners

public void notifyListeners(AtmosphereResourceEvent event)

Notify AtmosphereResourceEventListener.

Specified by:

notifyListeners in interface AtmosphereEventLifecycle

Parameters:

event - an instance of AtmosphereResourceEvent

onThrowable

public void onThrowable(Throwable t)

Notify AtmosphereResourceEventListener an unexpected exception occured.\

atmosphereResourceEventListener

public ConcurrentLinkedQueue<AtmosphereResourceEventListener> atmosphereResourceEventListener()

cancel

public void cancel()
            throws IOException

Throws:

IOException

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object