org.hawkular.bus.common.consumer

Class BasicMessageListener<T extends BasicMessage>

java.lang.Object

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

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

All Implemented Interfaces:

javax.jms.MessageListener

public abstract class BasicMessageListener<T extends BasicMessage>
extends AbstractBasicMessageListener<T>

A message listener that expects to receive a JSON-encoded BasicMessage or one of its subclasses. Implementors need not worry about the JSON decoding as it is handled for you Subclasses must override one and only one of the onBasicMessage(BasicMessageWithExtraData) or onBasicMessage(BasicMessage) methods. This processes fire-and-forget requests - that is, the request message is processed with no response being sent back to the sender.

Author:

John Mazzitelli

Constructor Summary

Constructors

Modifier	Constructor and Description
	BasicMessageListener()
protected	BasicMessageListener(Class<T> jsonDecoderRing)
protected	BasicMessageListener(ClassLoader basicMessageClassLoader)

Method Summary

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

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

BasicMessageListener

public BasicMessageListener()

BasicMessageListener

protected BasicMessageListener(Class<T> jsonDecoderRing)

BasicMessageListener

protected BasicMessageListener(ClassLoader basicMessageClassLoader)

Method Detail

onMessage

public void onMessage(javax.jms.Message message)

onBasicMessage

protected void onBasicMessage(BasicMessageWithExtraData<T> msgWithExtraData)

Subclasses implement this method to process the received message. If subclasses would rather just receive the BasicMessage, it can do so by overriding onBasicMessage(BasicMessage) 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

onBasicMessage

protected void onBasicMessage(T basicMessage)

Subclasses can implement this method rather than onBasicMessage(BasicMessageWithExtraData) if they only expect to receive a BasicMessage 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