net.engio.mbassy.dispatch

Interface IMessageDispatcher

All Known Implementing Classes:

EnvelopedMessageDispatcher, FilteredMessageDispatcher, MessageDispatcher

public interface IMessageDispatcher

A message dispatcher provides the functionality to deliver a single message to a set of listeners. A message dispatcher uses a message context to access all information necessary for the message delivery. The delivery of a single message to a single listener is responsibility of the handler invocation object associated with the dispatcher. Implementations if IMessageDispatcher are partially designed using decorator pattern such that it is possible to compose different message dispatchers to achieve more complex dispatch logic.

Author:

bennidi Date: 11/23/12

Method Summary

Methods

Modifier and Type	Method and Description
void	dispatch(Object message, ConcurrentSet listeners) Delivers the given message to the given set of listeners.
MessagingContext	getContext() Get the messaging context associated with this dispatcher
IHandlerInvocation	getInvocation() Get the handler invocation that will be used to deliver the message to each listener

Method Detail

dispatch

void dispatch(Object message,
            ConcurrentSet listeners)

Delivers the given message to the given set of listeners. Delivery may be delayed, aborted or restricted in various ways, depending on the configuration of the dispatcher

Parameters:

message - The message that should be delivered to the listeners

listeners - The listeners that should receive the message

getContext

MessagingContext getContext()

Get the messaging context associated with this dispatcher

Returns:

getInvocation

IHandlerInvocation getInvocation()

Get the handler invocation that will be used to deliver the message to each listener

Returns: