io.pythagoras.messagebus.core

Interface IMessageBus

All Known Implementing Classes:

MessageBusService

public interface IMessageBus

Method Summary

Modifier and Type	Method and Description
void	disableMessageBus() Disables the message bus.
void	enableMessageBus() Enables the message bus.
void	receiveMessage(IBusMessage busMessage) Handles a generic message coming in from the message Bus, and converts it into the specific contract types and dispatches it.
void	sendMessage(IMessageContract message) Takes the specific message, turns it into a generic message, and send to the message bus.

Method Detail

receiveMessage

void receiveMessage(IBusMessage busMessage)
             throws HandleMessageFailureException

Handles a generic message coming in from the message Bus, and converts it into the specific contract types and dispatches it.

Parameters:

busMessage - The message being received.

Throws:

HandleMessageFailureException - When the handling of the message fails.

sendMessage

void sendMessage(IMessageContract message)
          throws MessageSendingException

Takes the specific message, turns it into a generic message, and send to the message bus.

Parameters:

message - the message to send

Throws:

MessageSendingException - When there is a failure in sending.

disableMessageBus

void disableMessageBus()
                throws MessageBusStateException

Disables the message bus. If already disabled, then it does nothing. Will no longer send or receive messages.

Throws:

MessageBusStateException - When it is unable to result in a disabled state.

enableMessageBus

void enableMessageBus()
               throws MessageBusStateException

Enables the message bus. If already enabled then it does nothing. Will go through reinitialization of queues and topics which makes this an expensive call.

Throws:

MessageBusStateException