Package org.atmosphere.cache

Class AbstractBroadcasterCache

java.lang.Object

org.atmosphere.cache.AbstractBroadcasterCache

All Implemented Interfaces:

BroadcasterCache, AtmosphereConfigAware

Direct Known Subclasses:

SessionBroadcasterCache

public abstract class AbstractBroadcasterCache
extends java.lang.Object
implements BroadcasterCache

Abstract BroadcasterCache which is used to implement headers, query parameters or session based caching.

Author:

Paul Khodchenkov, Jeanfrancois Arcand

Field Summary

Fields

Modifier and Type	Field	Description
protected AtmosphereConfig	config
protected java.util.List<java.lang.Object>	emptyList
protected java.util.List<BroadcasterCacheInspector>	inspectors
protected long	invalidateCacheInterval
protected boolean	isShared
protected java.util.List<BroadcasterCacheListener>	listeners
protected long	maxCacheTime
protected java.util.List<CacheMessage>	messages
protected java.util.Set<java.lang.String>	messagesIds
protected java.util.concurrent.locks.ReadWriteLock	readWriteLock
protected java.util.concurrent.ScheduledExecutorService	reaper
protected java.util.concurrent.ScheduledFuture<?>	scheduledFuture

Fields inherited from interface org.atmosphere.cpr.BroadcasterCache

DEFAULT, NULL

Constructor Summary

Constructors

Constructor	Description
AbstractBroadcasterCache()

Method Summary

Modifier and Type	Method	Description
BroadcasterCache	addBroadcasterCacheListener(BroadcasterCacheListener l)	Add a BroadcasterCacheListener
BroadcasterCache	cacheCandidate(java.lang.String broadcasterId, java.lang.String uuid)	Add a AtmosphereResource.uuid() to the list of active AtmosphereResource Message will be cached for the resource associated with the uuid.
void	cleanup()	Clean resources associated with this instance.
BroadcasterCache	clearCache(java.lang.String broadcasterId, java.lang.String uuid, CacheMessage cache)	Remove the previously cached message.
void	configure(AtmosphereConfig config)	Configure an AtmosphereFramework object.
BroadcasterCache	excludeFromCache(java.lang.String broadcasterId, AtmosphereResource r)	Allow an application to exclude, or block, an AtmosphereResource to received cached message.
protected java.util.List<java.lang.Object>	get(long cacheHeaderTime)
protected boolean	inspect(BroadcastMessage m)
BroadcasterCache	inspector(BroadcasterCacheInspector b)	Add a BroadcasterCacheInspector that will be invoked before a message gets added to the cache.
protected CacheMessage	put(BroadcastMessage message, java.lang.Long now, java.lang.String uuid)
BroadcasterCache	removeBroadcasterCacheListener(BroadcasterCacheListener l)	Remove a BroadcasterCacheListener
AbstractBroadcasterCache	setInvalidateCacheInterval(long invalidateCacheInterval)	Set the delay between cache purges.
AbstractBroadcasterCache	setMaxCacheTime(long maxCacheTime)	Set the maximum time a message stays alive in the cache.
void	start()	This method is invoked when the Broadcaster is started.
void	stop()	This method is invoked when the Broadcaster is stopped.

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.BroadcasterCache

addToCache, retrieveFromCache

Field Detail

messages

protected final java.util.List<CacheMessage> messages

messagesIds

protected final java.util.Set<java.lang.String> messagesIds

readWriteLock

protected final java.util.concurrent.locks.ReadWriteLock readWriteLock

scheduledFuture

protected java.util.concurrent.ScheduledFuture<?> scheduledFuture

maxCacheTime

protected long maxCacheTime

invalidateCacheInterval

protected long invalidateCacheInterval

reaper

protected java.util.concurrent.ScheduledExecutorService reaper

isShared

protected boolean isShared

inspectors

protected final java.util.List<BroadcasterCacheInspector> inspectors

emptyList

protected final java.util.List<java.lang.Object> emptyList

listeners

protected final java.util.List<BroadcasterCacheListener> listeners

config

protected AtmosphereConfig config

Constructor Detail

AbstractBroadcasterCache

public AbstractBroadcasterCache()

Method Detail

start

public void start()

Description copied from interface: BroadcasterCache

This method is invoked when the Broadcaster is started.

Specified by:

start in interface BroadcasterCache

cleanup

public void cleanup()

Description copied from interface: BroadcasterCache

Clean resources associated with this instance. This method is useful when ExecutorServices are shared and some future must be cancelled. This method will always be invoked when a Broadcaster gets destroyed.

Specified by:

cleanup in interface BroadcasterCache

stop

public void stop()

Description copied from interface: BroadcasterCache

This method is invoked when the Broadcaster is stopped.

Specified by:

stop in interface BroadcasterCache

put

protected CacheMessage put(BroadcastMessage message,
                           java.lang.Long now,
                           java.lang.String uuid)

get

protected java.util.List<java.lang.Object> get(long cacheHeaderTime)

setInvalidateCacheInterval

public AbstractBroadcasterCache setInvalidateCacheInterval(long invalidateCacheInterval)

Set the delay between cache purges.

Parameters:

invalidateCacheInterval - the purge interval in milliseconds

Returns:

this

setMaxCacheTime

public AbstractBroadcasterCache setMaxCacheTime(long maxCacheTime)

Set the maximum time a message stays alive in the cache.

Parameters:

maxCacheTime - the maximum time in milliseconds.

Returns:

this

inspector

public BroadcasterCache inspector(BroadcasterCacheInspector b)

Description copied from interface: BroadcasterCache

Add a BroadcasterCacheInspector that will be invoked before a message gets added to the cache.

Specified by:

inspector in interface BroadcasterCache

Parameters:

b - an instance of BroadcasterCacheInspector

Returns:

this

inspect

protected boolean inspect(BroadcastMessage m)

configure

public void configure(AtmosphereConfig config)

Description copied from interface: AtmosphereConfigAware

Configure an AtmosphereFramework object.

Specified by:

configure in interface AtmosphereConfigAware

Parameters:

config - AtmosphereConfig

clearCache

public BroadcasterCache clearCache(java.lang.String broadcasterId,
                                   java.lang.String uuid,
                                   CacheMessage cache)

Description copied from interface: BroadcasterCache

Remove the previously cached message.

Specified by:

clearCache in interface BroadcasterCache

Parameters:

broadcasterId - The Broadcaster.getID()

uuid - an AtmosphereResource.uuid()

cache - the CacheMessage

excludeFromCache

public BroadcasterCache excludeFromCache(java.lang.String broadcasterId,
                                         AtmosphereResource r)

Description copied from interface: BroadcasterCache

Allow an application to exclude, or block, an AtmosphereResource to received cached message. No new message will get sent to this client except the ones already cached.

Specified by:

excludeFromCache in interface BroadcasterCache

Parameters:

broadcasterId - The Broadcaster.getID()

r - an AtmosphereResource

Returns:

this

cacheCandidate

public BroadcasterCache cacheCandidate(java.lang.String broadcasterId,
                                       java.lang.String uuid)

Description copied from interface: BroadcasterCache

Add a AtmosphereResource.uuid() to the list of active AtmosphereResource Message will be cached for the resource associated with the uuid.

Specified by:

cacheCandidate in interface BroadcasterCache

Parameters:

broadcasterId - The Broadcaster.getID()

uuid - an AtmosphereResource.uuid()

Returns:

this

addBroadcasterCacheListener

public BroadcasterCache addBroadcasterCacheListener(BroadcasterCacheListener l)

Description copied from interface: BroadcasterCache

Add a BroadcasterCacheListener

Specified by:

addBroadcasterCacheListener in interface BroadcasterCache

Parameters:

l - a BroadcasterCacheListener

Returns:

this

removeBroadcasterCacheListener

public BroadcasterCache removeBroadcasterCacheListener(BroadcasterCacheListener l)

Description copied from interface: BroadcasterCache

Remove a BroadcasterCacheListener

Specified by:

removeBroadcasterCacheListener in interface BroadcasterCache

Parameters:

l - a BroadcasterCacheListener

Returns:

this