net.engio.mbassy.bus

Class AbstractSyncMessageBus<T,P extends IPublicationCommand>

java.lang.Object

net.engio.mbassy.bus.AbstractSyncMessageBus<T,P>

Type Parameters:

T -

P -

All Implemented Interfaces:

ErrorHandlingSupport, GenericMessagePublicationSupport<T,P>, ISyncMessageBus<T,P>, PubSubSupport<T>, RuntimeProvider

Direct Known Subclasses:

AbstractSyncAsyncMessageBus, SyncMessageBus

public abstract class AbstractSyncMessageBus<T,P extends IPublicationCommand>
extends Object
implements ISyncMessageBus<T,P>

The base class for all message bus implementations.

Constructor Summary

Constructors

Constructor and Description
AbstractSyncMessageBus(ISyncBusConfiguration configuration)

Method Summary

Methods

Modifier and Type	Method and Description
void	addErrorHandler(IPublicationErrorHandler handler) Publication errors may occur at various points of time during message delivery.
protected MessagePublication	createMessagePublication(T message)
protected MessagePublication.Factory	getPublicationFactory()
Collection<IPublicationErrorHandler>	getRegisteredErrorHandlers() Returns an immutable collection containing all the registered error handlers
BusRuntime	getRuntime()
protected Collection<Subscription>	getSubscriptionsByMessageType(Class messageType)
void	handlePublicationError(PublicationError error)
void	subscribe(Object listener) Subscribe all handlers of the given listener.
boolean	unsubscribe(Object listener) Immediately remove all registered message handlers (if any) of the given listener.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.engio.mbassy.bus.PubSubSupport

publish

Methods inherited from interface net.engio.mbassy.bus.GenericMessagePublicationSupport

post

Constructor Detail

AbstractSyncMessageBus

public AbstractSyncMessageBus(ISyncBusConfiguration configuration)

Method Detail

getPublicationFactory

protected MessagePublication.Factory getPublicationFactory()

getRegisteredErrorHandlers

public Collection<IPublicationErrorHandler> getRegisteredErrorHandlers()

Description copied from interface: ErrorHandlingSupport

Returns an immutable collection containing all the registered error handlers

Specified by:

getRegisteredErrorHandlers in interface ErrorHandlingSupport

Returns:

unsubscribe

public boolean unsubscribe(Object listener)

Description copied from interface: PubSubSupport

Immediately remove all registered message handlers (if any) of the given listener. When this call returns all handlers have effectively been removed and will not receive any messages (provided that running publications (iterators) in other threads have not yet obtained a reference to the listener)

A call to this method passing any object that is not subscribed will not have any effect and is silently ignored.

Specified by:

unsubscribe in interface PubSubSupport<T>

Returns:

true, if the listener was found and successfully removed false otherwise

subscribe

public void subscribe(Object listener)

Description copied from interface: PubSubSupport

Subscribe all handlers of the given listener. Any listener is only subscribed once -> subsequent subscriptions of an already subscribed listener will be silently ignored

Specified by:

subscribe in interface PubSubSupport<T>

addErrorHandler

public final void addErrorHandler(IPublicationErrorHandler handler)

Description copied from interface: ErrorHandlingSupport

Publication errors may occur at various points of time during message delivery. A handler may throw an exception, may not be accessible due to security constraints or is not annotated properly. In any of all possible cases a publication error is created and passed to each of the registered error handlers. A call to this method will add the given error handler to the chain

Specified by:

addErrorHandler in interface ErrorHandlingSupport

getRuntime

public BusRuntime getRuntime()

Specified by:

getRuntime in interface RuntimeProvider

createMessagePublication

protected MessagePublication createMessagePublication(T message)

getSubscriptionsByMessageType

protected Collection<Subscription> getSubscriptionsByMessageType(Class messageType)

handlePublicationError

public void handlePublicationError(PublicationError error)