org.glassfish.hk2.extras.events.internal

Class DefaultTopicDistributionService

java.lang.Object

org.glassfish.hk2.extras.events.internal.DefaultTopicDistributionService

All Implemented Interfaces:

DynamicConfigurationListener, InstanceLifecycleListener, TopicDistributionService

@Singleton
 @Named(value="HK2TopicDistributionService")
 @ContractsProvided(value={TopicDistributionService.class,InstanceLifecycleListener.class,DynamicConfigurationListener.class})
public class DefaultTopicDistributionService
extends Object
implements TopicDistributionService, InstanceLifecycleListener, DynamicConfigurationListener

This is the default implementation of the TopicDistributionService.

Author:

jwells

Field Summary

Fields inherited from interface org.glassfish.hk2.api.messaging.TopicDistributionService

HK2_DEFAULT_TOPIC_DISTRIBUTOR

Constructor Summary

Constructors

Constructor and Description
DefaultTopicDistributionService()

Method Summary

Modifier and Type	Method and Description
void	configurationChanged() This method is called when the set of descriptors in this service locator has been changed.
void	distributeMessage(Topic<?> topic, Object message) Must distribute the message to all of the matching topic subscribers.
Filter	getFilter() This returns a filter that tells the system whether a particular descriptor should be handled by this lifecycle listener.
void	lifecycleEvent(InstanceLifecycleEvent lifecycleEvent) This method will be called when any lifecycle event occurs.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultTopicDistributionService

public DefaultTopicDistributionService()

Method Detail

distributeMessage

public void distributeMessage(Topic<?> topic,
                              Object message)

Description copied from interface: TopicDistributionService

Must distribute the message to all of the matching topic subscribers. Any exception thrown from this method will be ignored. Instead error handling should be performed by the implementation of this message

Specified by:

distributeMessage in interface TopicDistributionService

Parameters:

topic - The topic to which to distribute the message. Must not be null

message - The message to send to the topic. Must not be null

getFilter

public Filter getFilter()

Description copied from interface: InstanceLifecycleListener

This returns a filter that tells the system whether a particular descriptor should be handled by this lifecycle listener. The filter can be called at any time

Specified by:

getFilter in interface InstanceLifecycleListener

Returns:

The filter that tells the system if this listener applies to this descriptor. If this returns null then this Listener will apply to ALL descriptors.

lifecycleEvent

public void lifecycleEvent(InstanceLifecycleEvent lifecycleEvent)

Description copied from interface: InstanceLifecycleListener

This method will be called when any lifecycle event occurs. The currently supported lifecycle events are PRE_PRODUCTION, POST_PRODUCTION and PRE_DESTRUCTION. Code should be written to allow for future events to be generated. This method should not throw exceptions

Specified by:

lifecycleEvent in interface InstanceLifecycleListener

Parameters:

lifecycleEvent - The event that has occurred, will not be null

configurationChanged

public void configurationChanged()

Description copied from interface: DynamicConfigurationListener

This method is called when the set of descriptors in this service locator has been changed. Changes to parent service locators descriptors will not be reported. These services are called back on the thread doing the DynamicConfiguration.commit() so care should be taken to do any work quickly. Any exception thrown from this method will be ignored. A commit that failed will not be reported to this method

Specified by:

configurationChanged in interface DynamicConfigurationListener