org.atmosphere.cpr

Class BroadcasterFactory

java.lang.Object

org.atmosphere.cpr.BroadcasterFactory

Direct Known Subclasses:

DefaultBroadcasterFactory

public abstract class BroadcasterFactory
extends java.lang.Object

Broadcaster factory used by Atmosphere when creating broadcaster.

Author:

Jeanfrancois Arcand

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.ConcurrentLinkedQueue<BroadcasterListener>	broadcasterListeners
protected static BroadcasterFactory	factory

Constructor Summary

Constructors

Constructor and Description
BroadcasterFactory()

Method Summary

Methods

Modifier and Type	Method and Description
abstract boolean	add(Broadcaster b, java.lang.Object id) Add a Broadcaster to the list.
BroadcasterFactory	addBroadcasterListener(BroadcasterListener b)
abstract void	destroy() Shutdown all Broadcaster
abstract Broadcaster	get() Return an instance of the default Broadcaster The name of the Broadcaster will be randmly generated.
abstract Broadcaster	get(java.lang.Class<? extends Broadcaster> c, java.lang.Object id) Create a new instance of Broadcaster and store it for
abstract Broadcaster	get(java.lang.Object id) Create a new instance of Broadcaster and store it for
static BroadcasterFactory	getDefault() Return the default BroadcasterFactory.
abstract Broadcaster	lookup(java.lang.Class<? extends Broadcaster> c, java.lang.Object id) Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()
abstract Broadcaster	lookup(java.lang.Class<? extends Broadcaster> c, java.lang.Object id, boolean createIfNull) Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()
abstract Broadcaster	lookup(java.lang.Object id) Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()
abstract Broadcaster	lookup(java.lang.Object id, boolean createIfNull) Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()
abstract java.util.Collection<Broadcaster>	lookupAll() Return an immutable Collection of Broadcaster this factory contains.
abstract boolean	remove(Broadcaster b, java.lang.Object id) Remove a Broadcaster to the list.
abstract boolean	remove(java.lang.Object id) Remove the associated Broadcaster
abstract void	removeAllAtmosphereResource(AtmosphereResource r) Remove all instance of AtmosphereResource from all registered Broadcaster
BroadcasterFactory	removeBroadcasterListener(BroadcasterListener b)

Methods inherited from class java.lang.Object

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

Field Detail

factory

protected static BroadcasterFactory factory

broadcasterListeners

protected final java.util.concurrent.ConcurrentLinkedQueue<BroadcasterListener> broadcasterListeners

Constructor Detail

BroadcasterFactory

public BroadcasterFactory()

Method Detail

get

public abstract Broadcaster get()

Return an instance of the default Broadcaster The name of the Broadcaster will be randmly generated.

Returns:

an instance of the default Broadcaster

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

get

public abstract Broadcaster get(java.lang.Object id)

Create a new instance of Broadcaster and store it for

Parameters:

id - The unique ID used to retrieve Broadcaster

Returns:

a new instance of Broadcaster

get

public abstract Broadcaster get(java.lang.Class<? extends Broadcaster> c,
              java.lang.Object id)

Create a new instance of Broadcaster and store it for

Parameters:

c - The Broadcaster class instance.

id - The unique ID used to retrieve Broadcaster

Returns:

a new instance of Broadcaster

destroy

public abstract void destroy()

Shutdown all Broadcaster

add

public abstract boolean add(Broadcaster b,
          java.lang.Object id)

Add a Broadcaster to the list.

Parameters:

b - a Broadcaster

Returns:

false if a with the same name Broadcaster was already stored

remove

public abstract boolean remove(Broadcaster b,
             java.lang.Object id)

Remove a Broadcaster to the list.

Parameters:

b - a Broadcaster

id - the ID

Returns:

false if wasn't present, or Broadcaster

lookup

public abstract Broadcaster lookup(java.lang.Class<? extends Broadcaster> c,
                 java.lang.Object id)

Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()

Parameters:

c -

id - The Broadcaster's unique ID, or name.

Returns:

a Broadcaster, or null if not found.

lookup

public abstract Broadcaster lookup(java.lang.Class<? extends Broadcaster> c,
                 java.lang.Object id,
                 boolean createIfNull)

Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()

Parameters:

c -

id - The Broadcaster's unique ID, or name.

createIfNull - If the broadcaster is not found, create it.

Returns:

a Broadcaster, or null if not found.

lookup

public abstract Broadcaster lookup(java.lang.Object id)

Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()

Parameters:

id - The Broadcaster's unique ID, or name.

Returns:

a Broadcaster, or null if not found.

lookup

public abstract Broadcaster lookup(java.lang.Object id,
                 boolean createIfNull)

Lookup a Broadcaster instance using Broadcaster.getID() or ID used when invoking getDefault()

Parameters:

id - The Broadcaster's unique ID, or name.

createIfNull - If the broadcaster is not found, create it.

Returns:

a Broadcaster, or null if not found.

removeAllAtmosphereResource

public abstract void removeAllAtmosphereResource(AtmosphereResource r)

Remove all instance of AtmosphereResource from all registered Broadcaster

Parameters:

r - an void AtmosphereResource

remove

public abstract boolean remove(java.lang.Object id)

Remove the associated Broadcaster

lookupAll

public abstract java.util.Collection<Broadcaster> lookupAll()

Return an immutable Collection of Broadcaster this factory contains.

Returns:

an immutable Collection of Broadcaster this factory contains.

getDefault

public static BroadcasterFactory getDefault()

Return the default BroadcasterFactory.

Returns:

the default BroadcasterFactory.

addBroadcasterListener

public BroadcasterFactory addBroadcasterListener(BroadcasterListener b)

removeBroadcasterListener

public BroadcasterFactory removeBroadcasterListener(BroadcasterListener b)