org.atmosphere.cache

Class AbstractBroadcasterCache

java.lang.Object

org.atmosphere.cache.AbstractBroadcasterCache

All Implemented Interfaces:

BroadcasterCache

Direct Known Subclasses:

HeaderBroadcasterCache, 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 and Description
protected java.util.List<java.lang.Object>	emptyList
protected java.util.List<BroadcasterCacheInspector>	inspectors
protected long	invalidateCacheInterval
protected boolean	isShared
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

Constructor Summary

Constructors

Constructor and Description
AbstractBroadcasterCache()

Method Summary

Modifier and Type	Method and Description
void	cleanup() Clean resources associated with this instance.
void	clearCache(java.lang.String broadcasterId, AtmosphereResource r, CacheMessage cache) Remove the previously cached message.
void	configure(BroadcasterConfig config) Configure the cache.
void	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)
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

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)

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(BroadcasterConfig config)

Description copied from interface: BroadcasterCache

Configure the cache.

Specified by:

configure in interface BroadcasterCache

Parameters:

config - a BroadcasterConfig

clearCache

public void clearCache(java.lang.String broadcasterId,
                       AtmosphereResource r,
                       CacheMessage cache)

Description copied from interface: BroadcasterCache

Remove the previously cached message.

Specified by:

clearCache in interface BroadcasterCache

Parameters:

broadcasterId - The Broadcaster.getID()

r - an AtmosphereResource

cache - the CacheMessage

excludeFromCache

public void 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