BroadcasterConfig (atmosphere-runtime 2.7.1 API)

java.lang.Object
- org.atmosphere.cpr.BroadcasterConfig

```
public class BroadcasterConfig
extends java.lang.Object
```
Handle Broadcaster configuration like ExecutorService and BroadcastFilter.

Author:

Jeanfrancois Arcand

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`BroadcasterConfig.FilterManipulator` Manipulate the message before and after they are getting filtered by `BroadcastFilter`

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.util.concurrent.ConcurrentLinkedQueue<BroadcastFilter>`	`filters`
`protected java.util.concurrent.ConcurrentLinkedQueue<PerRequestBroadcastFilter>`	`perRequestFilters`

Constructor Summary

Constructors
Constructor and Description
`BroadcasterConfig(java.util.concurrent.ExecutorService executorService, java.util.concurrent.ExecutorService asyncWriteService, java.util.concurrent.ScheduledExecutorService scheduler, AtmosphereConfig config, java.lang.String broadcasterId)` Create a new BroadcasterConfig.
`BroadcasterConfig(java.util.List<java.lang.String> broadcastFilters, AtmosphereConfig config, boolean handleExecutors, java.lang.String broadcasterId)` Create a new BroadcasterConfig.
`BroadcasterConfig(java.util.List<java.lang.String> broadcastFilters, AtmosphereConfig config, java.lang.String broadcasterId)` Create a new BroadcasterConfig.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`addFilter(BroadcastFilter e)` Add a `BroadcastFilter`.
`protected boolean`	`addFilter(BroadcastFilter e, boolean init)` Add a `BroadcastFilter`.
`java.util.List<java.lang.Object>`	`applyFilters(AtmosphereResource r, java.util.List<java.lang.Object> cacheMessages)` Apply all filters to the `AtmosphereResource` and the provided `List` of messages.
`protected BroadcasterConfig`	`broadcasterID(java.lang.String broadcasterId)`
`protected void`	`configExecutors()`
`protected void`	`configureSharedCacheExecutor()`
`void`	`destroy()`
`protected void`	`destroy(boolean force)`
`protected BroadcastFilter.BroadcastAction`	`filter(AtmosphereResource r, java.lang.Object message, java.lang.Object originalMessage)` Invoke `BroadcastFilter`s in the order they were added, with a unique `AtmosphereRequest`.
`protected BroadcastFilter.BroadcastAction`	`filter(java.lang.Object object)` Invoke `BroadcastFilter`s in the order they were added.
`java.util.Collection<BroadcastFilter>`	`filters()` Return the current list of installed `BroadcastFilter`s.
`void`	`forceDestroy()` Force shutdown of all `ExecutorService`s.
`java.util.concurrent.ExecutorService`	`getAsyncWriteService()` Return the `ExecutorService` this `Broadcaster` use for executing asynchronous write of events.
`AtmosphereConfig`	`getAtmosphereConfig()` Return the `AtmosphereConfig` value.
`BroadcasterCache`	`getBroadcasterCache()` Get the `BroadcasterCache` used for this `Broadcaster`.
`java.util.concurrent.ExecutorService`	`getExecutorService()` Return the `ExecutorService` this `Broadcaster` supports.
`java.util.concurrent.ScheduledExecutorService`	`getScheduledExecutorService()` Return the `ScheduledExecutorService` this `Broadcaster` supports.
`boolean`	`handleExecutors()`
`boolean`	`hasFilters()` Check if this object contains `BroadcastFilter`s.
`boolean`	`hasPerRequestFilters()` Check if this object contains `BroadcastFilter`s.
`BroadcasterConfig`	`init()` Initialize BroadcastFilters and BroadcasterCache.
`protected void`	`initClusterExtension()`
`void`	`removeAllFilters()` Remove all `BroadcastFilter`s.
`boolean`	`removeFilter(BroadcastFilter filter)` Remove a `BroadcastFilter`.
`BroadcasterConfig`	`setAsyncWriteService(java.util.concurrent.ExecutorService asyncWriteService)` Set an `ExecutorService` which can be used to write `AtmosphereResourceEvent.getMessage()`.
`BroadcasterConfig`	`setAsyncWriteService(java.util.concurrent.ExecutorService asyncWriteService, boolean isAsyncExecutorShared)` Set an `ExecutorService` which can be used to write `AtmosphereResourceEvent.getMessage()`.
`BroadcasterConfig`	`setBroadcasterCache(BroadcasterCache broadcasterCache)` Set a `BroadcasterCache`.
`BroadcasterConfig`	`setExecutorService(java.util.concurrent.ExecutorService executorService)` Set an `ExecutorService` which can be used to dispatch `AtmosphereResourceEvent`.
`BroadcasterConfig`	`setExecutorService(java.util.concurrent.ExecutorService executorService, boolean isExecutorShared)` Set an `ExecutorService` which can be used to dispatch `AtmosphereResourceEvent`.
`BroadcasterConfig`	`setScheduledExecutorService(java.util.concurrent.ScheduledExecutorService scheduler)` Set an `ExecutorService` which can be used to dispatch `AtmosphereResourceEvent`s.
`protected java.lang.Object`	`unwrap(java.lang.Object o)`
`protected BroadcastFilter.BroadcastAction`	`wrap(BroadcastFilter.BroadcastAction a, boolean wasUnwraped)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - filters
```
protected final java.util.concurrent.ConcurrentLinkedQueue<BroadcastFilter> filters
```
  - perRequestFilters
```
protected final java.util.concurrent.ConcurrentLinkedQueue<PerRequestBroadcastFilter> perRequestFilters
```
- Constructor Detail
  - BroadcasterConfig
```
public BroadcasterConfig(java.util.List<java.lang.String> broadcastFilters,
                         AtmosphereConfig config,
                         java.lang.String broadcasterId)
```
    Create a new BroadcasterConfig. Remember to call init() after the object has been created.
  - BroadcasterConfig
```
public BroadcasterConfig(java.util.List<java.lang.String> broadcastFilters,
                         AtmosphereConfig config,
                         boolean handleExecutors,
                         java.lang.String broadcasterId)
```
    Create a new BroadcasterConfig. Remember to call init() after the object has been created.
  - BroadcasterConfig
```
public BroadcasterConfig(java.util.concurrent.ExecutorService executorService,
                         java.util.concurrent.ExecutorService asyncWriteService,
                         java.util.concurrent.ScheduledExecutorService scheduler,
                         AtmosphereConfig config,
                         java.lang.String broadcasterId)
```
    Create a new BroadcasterConfig. Remember to call init() after the object has been created.
- Method Detail
  - init
```
public BroadcasterConfig init()
```
    Initialize BroadcastFilters and BroadcasterCache. Must always be called after creating a new BroadcasterConfig!
  - configureSharedCacheExecutor
```
protected void configureSharedCacheExecutor()
```
  - broadcasterID
```
protected BroadcasterConfig broadcasterID(java.lang.String broadcasterId)
```
  - initClusterExtension
```
protected void initClusterExtension()
```
  - handleExecutors
```
public boolean handleExecutors()
```
  - configExecutors
```
protected void configExecutors()
```
  - setExecutorService
```
public BroadcasterConfig setExecutorService(java.util.concurrent.ExecutorService executorService)
```
    Set an ExecutorService which can be used to dispatch AtmosphereResourceEvent. By default, the result of ExecutorsFactory.getMessageDispatcher(AtmosphereConfig, String) is used if this method is not invoked.
    
    Parameters:
    
    executorService - to be used when broadcasting.
  - setExecutorService
```
public BroadcasterConfig setExecutorService(java.util.concurrent.ExecutorService executorService,
                                            boolean isExecutorShared)
```
    Set an ExecutorService which can be used to dispatch AtmosphereResourceEvent. By default, the result of ExecutorsFactory.getMessageDispatcher(AtmosphereConfig, String) is used if this method is not invoked.
    
    Parameters:
    
    executorService - to be used when broadcasting.
    
    isExecutorShared - true if the life cycle of the ExecutorService will be executed by the application. It means Atmosphere will NOT invoke the shutdown method when destroy() is invoked.
  - getExecutorService
```
public java.util.concurrent.ExecutorService getExecutorService()
```
    Return the ExecutorService this Broadcaster supports. By default it returns the result of ExecutorsFactory.getMessageDispatcher(AtmosphereConfig, String)}.
    
    Returns:
    
    An ExecutorService.
  - setAsyncWriteService
```
public BroadcasterConfig setAsyncWriteService(java.util.concurrent.ExecutorService asyncWriteService)
```
    Set an ExecutorService which can be used to write AtmosphereResourceEvent.getMessage(). By default, the result of ExecutorsFactory.getAsyncOperationExecutor(AtmosphereConfig, String) is used if this method is not invoked.
    
    Parameters:
    
    asyncWriteService - to be used when writing events.
  - setAsyncWriteService
```
public BroadcasterConfig setAsyncWriteService(java.util.concurrent.ExecutorService asyncWriteService,
                                              boolean isAsyncExecutorShared)
```
    Set an ExecutorService which can be used to write AtmosphereResourceEvent.getMessage(). By default, the result of ExecutorsFactory.getAsyncOperationExecutor(AtmosphereConfig, String) is used if this method is not invoked.
    
    Parameters:
    
    asyncWriteService - to be used when writing events.
    
    isAsyncExecutorShared - true if the life cycle of the ExecutorService will be executed by the application. It means Atmosphere will NOT invoke the shutdown method when this destroy() is invoked.
  - getAsyncWriteService
```
public java.util.concurrent.ExecutorService getAsyncWriteService()
```
    Return the ExecutorService this Broadcaster use for executing asynchronous write of events. By default it returns the result of ExecutorsFactory.getAsyncOperationExecutor(AtmosphereConfig, String).
    
    Returns:
    
    An ExecutorService.
  - addFilter
```
public boolean addFilter(BroadcastFilter e)
```
    Add a BroadcastFilter.
    
    Parameters:
    
    e - BroadcastFilter
    
    Returns:
    
    true if successfully added
  - addFilter
```
protected boolean addFilter(BroadcastFilter e,
                            boolean init)
```
    Add a BroadcastFilter.
    
    Parameters:
    
    e - BroadcastFilter
    
    Returns:
    
    true if successfully added
  - filters
```
public java.util.Collection<BroadcastFilter> filters()
```
    Return the current list of installed BroadcastFilters.
    
    Returns:
    
    the current list of installed BroadcastFilters
  - destroy
```
public void destroy()
```
  - destroy
```
protected void destroy(boolean force)
```
  - forceDestroy
```
public void forceDestroy()
```
    Force shutdown of all ExecutorServices.
  - removeFilter
```
public boolean removeFilter(BroadcastFilter filter)
```
    Remove a BroadcastFilter.
    
    Parameters:
    
    filter - BroadcastFilter
    
    Returns:
    
    true if successfully removed
  - removeAllFilters
```
public void removeAllFilters()
```
    Remove all BroadcastFilters.
  - hasFilters
```
public boolean hasFilters()
```
    Check if this object contains BroadcastFilters.
    
    Returns:
    
    true if this object contains BroadcastFilters
  - hasPerRequestFilters
```
public boolean hasPerRequestFilters()
```
    Check if this object contains BroadcastFilters.
    
    Returns:
    
    true if this object contains BroadcastFilters
  - filter
```
protected BroadcastFilter.BroadcastAction filter(java.lang.Object object)
```
    Invoke BroadcastFilters in the order they were added.
    
    Parameters:
    
    object - the broadcasted object.
    
    Returns:
    
    BroadcastAction that tell Atmosphere to invoke the next filter or not.
  - filter
```
protected BroadcastFilter.BroadcastAction filter(AtmosphereResource r,
                                                 java.lang.Object message,
                                                 java.lang.Object originalMessage)
```
    Invoke BroadcastFilters in the order they were added, with a unique AtmosphereRequest.
    
    Parameters:
    
    r - AtmosphereResource
    
    message - the broadcasted object.
    
    message - the broadcasted object.
    
    Returns:
    
    BroadcastAction that tell Atmosphere to invoke the next filter or not.
  - applyFilters
```
public java.util.List<java.lang.Object> applyFilters(AtmosphereResource r,
                                                     java.util.List<java.lang.Object> cacheMessages)
```
    Apply all filters to the AtmosphereResource and the provided List of messages.
    
    Parameters:
    
    r - AtmosphereResource
    
    cacheMessages - list of messages
    
    Returns:
    
    the new list of objects.
  - setScheduledExecutorService
```
public BroadcasterConfig setScheduledExecutorService(java.util.concurrent.ScheduledExecutorService scheduler)
```
    Set an ExecutorService which can be used to dispatch AtmosphereResourceEvents. By default a ScheduledExecutorService is used if this method is not invoked.
    
    Parameters:
    
    scheduler - to be used when broadcasting.
    
    Returns:
    
    this.
  - getScheduledExecutorService
```
public java.util.concurrent.ScheduledExecutorService getScheduledExecutorService()
```
    Return the ScheduledExecutorService this Broadcaster supports. By default it returns an Executors.newScheduledThreadPool(int) and will use the underlying number of core/protocol as an indication of the thread number.
    
    Returns:
    
    An ExecutorService.
  - setBroadcasterCache
```
public BroadcasterConfig setBroadcasterCache(BroadcasterCache broadcasterCache)
```
    Set a BroadcasterCache.
    
    Parameters:
    
    broadcasterCache - a BroadcasterCache
    
    Returns:
    
    this
  - getBroadcasterCache
```
public BroadcasterCache getBroadcasterCache()
```
    Get the BroadcasterCache used for this Broadcaster.
    
    Returns:
    
    a BroadcasterCache
  - unwrap
```
protected java.lang.Object unwrap(java.lang.Object o)
```
  - wrap
```
protected BroadcastFilter.BroadcastAction wrap(BroadcastFilter.BroadcastAction a,
                                               boolean wasUnwraped)
```
  - getAtmosphereConfig
```
public AtmosphereConfig getAtmosphereConfig()
```
    Return the AtmosphereConfig value. This value might be null if the associated Broadcaster has been created manually.
    
    Returns:
    
    AtmosphereConfig

Class BroadcasterConfig

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

filters

perRequestFilters

Constructor Detail

BroadcasterConfig

BroadcasterConfig

BroadcasterConfig

Method Detail

init

configureSharedCacheExecutor

broadcasterID

initClusterExtension

handleExecutors

configExecutors

setExecutorService

setExecutorService

getExecutorService

setAsyncWriteService

setAsyncWriteService

getAsyncWriteService

addFilter

addFilter

filters

destroy

destroy

forceDestroy

removeFilter

removeAllFilters

hasFilters

hasPerRequestFilters

filter

filter

applyFilters

setScheduledExecutorService

getScheduledExecutorService

setBroadcasterCache

getBroadcasterCache

unwrap

wrap

getAtmosphereConfig