org.hawkular.bus.common.consumer

Class RPCBasicMessageListener<T extends BasicMessage,U extends BasicMessage>

java.lang.Object

org.hawkular.bus.common.consumer.AbstractBasicMessageListener<T>

org.hawkular.bus.common.consumer.RPCBasicMessageListener<T,U>

Type Parameters:

T - the type of the incoming request message

U - the type of the response message that is to be sent back to the request sender

All Implemented Interfaces:

javax.jms.MessageListener

public abstract class RPCBasicMessageListener<T extends BasicMessage,U extends BasicMessage>
extends AbstractBasicMessageListener<T>

A listener that processes an incoming request that will require a response sent back to the sender of the request. Subclasses must override one and only one of the onBasicMessage(BasicMessageWithExtraData) or #onBasicMessage(AbstractMessage) methods.

Author:

John Mazzitelli

Constructor Summary

Constructors

Modifier	Constructor and Description
	RPCBasicMessageListener() Initialize with a default message sender.
protected	RPCBasicMessageListener(Class<T> jsonDecoderRing)
protected	RPCBasicMessageListener(Class<T> jsonDecoderRing, MessageProcessor messageSender)
	RPCBasicMessageListener(MessageProcessor messageSender)

Method Summary

Modifier and Type	Method and Description
protected MessageProcessor	getMessageSender()
protected U	onBasicMessage(BasicMessageWithExtraData<T> msgWithExtraData) Subclasses implement this method to process the received message.
protected U	onBasicMessage(T basicMessage) Subclasses can implement this method rather than onBasicMessage(BasicMessageWithExtraData) if they only expect to receive a AbstractMessage with no additional data.
void	onMessage(javax.jms.Message message)
protected void	setMessageSender(MessageProcessor messageSender)

Methods inherited from class org.hawkular.bus.common.consumer.AbstractBasicMessageListener

convertReceivedMessageClassNameToDesiredMessageClassName, determineBasicMessageClass, getBasicMessageClass, getConsumerConnectionContext, getLog, parseMessage, setConsumerConnectionContext

Methods inherited from class java.lang.Object

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

Constructor Detail

RPCBasicMessageListener

public RPCBasicMessageListener()

Initialize with a default message sender.

RPCBasicMessageListener

public RPCBasicMessageListener(MessageProcessor messageSender)

RPCBasicMessageListener

protected RPCBasicMessageListener(Class<T> jsonDecoderRing)

RPCBasicMessageListener

protected RPCBasicMessageListener(Class<T> jsonDecoderRing,
                                  MessageProcessor messageSender)

Method Detail

getMessageSender

protected MessageProcessor getMessageSender()

setMessageSender

protected void setMessageSender(MessageProcessor messageSender)

onMessage

public void onMessage(javax.jms.Message message)

onBasicMessage

protected U onBasicMessage(BasicMessageWithExtraData<T> msgWithExtraData)

Subclasses implement this method to process the received message. If subclasses would rather just receive the AbstractMessage, it can do so by overriding the onBasicMessage method that just takes the message type as a parameter and leaving this method as-is (that is, do NOT override this method).

Parameters:

msgWithExtraData - the basic message received with any extra data that came with it

Returns:

the response message - this will be forwarded to the sender of the request message

onBasicMessage

protected U onBasicMessage(T basicMessage)

Subclasses can implement this method rather than onBasicMessage(BasicMessageWithExtraData) if they only expect to receive a AbstractMessage with no additional data. If this method is overridden by subclasses, then the onBasicMessage(BasicMessageWithExtraData) should not be. This base implementation is a no-op.

Parameters:

basicMessage - the basic message received

Returns:

the response message - this will be forwarded to the sender of the request message