org.marketcetera.client.jms

Class IncomingJmsFactory

java.lang.Object

org.marketcetera.client.jms.JmsFactory

org.marketcetera.client.jms.IncomingJmsFactory

public class IncomingJmsFactory
extends JmsFactory

A factory of incoming Spring-wrapped JMS connections (connection handlers).

Since:

1.0.0

Version:

$Id: IncomingJmsFactory.java 16614 2013-07-03 22:35:32Z colin $

Author:

tlerios@marketcetera.com

Constructor Summary

Constructors

Constructor and Description
IncomingJmsFactory(ConnectionFactory connectionFactory, ExceptionListener exceptionListener) Creates a new factory that uses the given standard JMS connection factory to create connections, and directs exceptions to the given listener, if any.

Method Summary

Methods

Modifier and Type	Method and Description
ExceptionListener	getExceptionListener() Returns the receiver's exception listener.
SimpleMessageListenerContainer	registerHandler(ReceiveOnlyHandler<?> handler, String inDstName, boolean isInDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandler(ReceiveOnlyHandler<?> handler, String inDstName, boolean isInDstTopic, MessageConverter messageConverter) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandler(ReplyHandler<?> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandler(ReplyHandler<?> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic, MessageConverter messageConverter) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerBSX(ReceiveOnlyHandler<BrokerStatus> handler, String inDstName, boolean isInDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerBSX(ReplyHandler<BrokerStatus> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerOEX(ReceiveOnlyHandler<OrderEnvelope> handler, String inDstName, boolean isInDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerOEX(ReplyHandler<OrderEnvelope> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerQ(ReceiveOnlyHandler<Message> handler, String inDstName, boolean isInDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerQ(ReplyHandler<Message> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerTMX(ReceiveOnlyHandler<TradeMessage> handler, String inDstName, boolean isInDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).
SimpleMessageListenerContainer	registerHandlerTMX(ReplyHandler<TradeMessage> handler, String inDstName, boolean isInDstTopic, String replyDstName, boolean isReplyDstTopic) Registers the given message handler for messages that are received by the given incoming destination (and of the given type).

Methods inherited from class org.marketcetera.client.jms.JmsFactory

getConnectionFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

IncomingJmsFactory

public IncomingJmsFactory(ConnectionFactory connectionFactory,
                  ExceptionListener exceptionListener)

Creates a new factory that uses the given standard JMS connection factory to create connections, and directs exceptions to the given listener, if any.

Parameters:

connectionFactory - The factory.

exceptionListener - The listener. It may be null.

Method Detail

getExceptionListener

public ExceptionListener getExceptionListener()

Returns the receiver's exception listener.

Returns:

The listener. It may be null.

registerHandler

public SimpleMessageListenerContainer registerHandler(ReplyHandler<?> handler,
                                             String inDstName,
                                             boolean isInDstTopic,
                                             String replyDstName,
                                             boolean isReplyDstTopic,
                                             MessageConverter messageConverter)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The given message converter is used to convert messages between the type used by the handler and the standard JMS message type. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

messageConverter - The converter.

Returns:

The container.

registerHandler

public SimpleMessageListenerContainer registerHandler(ReceiveOnlyHandler<?> handler,
                                             String inDstName,
                                             boolean isInDstTopic,
                                             MessageConverter messageConverter)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The given message converter is used to convert messages between the type used by the handler and the standard JMS message type. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

messageConverter - The converter.

Returns:

The container.

registerHandler

public SimpleMessageListenerContainer registerHandler(ReplyHandler<?> handler,
                                             String inDstName,
                                             boolean isInDstTopic,
                                             String replyDstName,
                                             boolean isReplyDstTopic)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The handler is expected to operate on objects supported by SimpleMessageConverter. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

Returns:

The container.

registerHandler

public SimpleMessageListenerContainer registerHandler(ReceiveOnlyHandler<?> handler,
                                             String inDstName,
                                             boolean isInDstTopic)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The handler is expected to operate on objects supported by SimpleMessageConverter. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

Returns:

The container.

registerHandlerQ

public SimpleMessageListenerContainer registerHandlerQ(ReplyHandler<Message> handler,
                                              String inDstName,
                                              boolean isInDstTopic,
                                              String replyDstName,
                                              boolean isReplyDstTopic)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The handler is expected to operate on QuickFIX/J messages. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

Returns:

The container.

registerHandlerQ

public SimpleMessageListenerContainer registerHandlerQ(ReceiveOnlyHandler<Message> handler,
                                              String inDstName,
                                              boolean isInDstTopic)

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The handler is expected to operate on QuickFIX/J messages. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

Returns:

The container.

registerHandlerTMX

public SimpleMessageListenerContainer registerHandlerTMX(ReplyHandler<TradeMessage> handler,
                                                String inDstName,
                                                boolean isInDstTopic,
                                                String replyDstName,
                                                boolean isReplyDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The handler is expected to operate on FIX Agnostic trade messages transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.

registerHandlerTMX

public SimpleMessageListenerContainer registerHandlerTMX(ReceiveOnlyHandler<TradeMessage> handler,
                                                String inDstName,
                                                boolean isInDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The handler is expected to operate on FIX Agnostic trade messages transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.

registerHandlerOEX

public SimpleMessageListenerContainer registerHandlerOEX(ReceiveOnlyHandler<OrderEnvelope> handler,
                                                String inDstName,
                                                boolean isInDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The handler is expected to operate on FIX Agnostic order message envelopes transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.

registerHandlerOEX

public SimpleMessageListenerContainer registerHandlerOEX(ReplyHandler<OrderEnvelope> handler,
                                                String inDstName,
                                                boolean isInDstTopic,
                                                String replyDstName,
                                                boolean isReplyDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The handler is expected to operate on FIX Agnostic order message envelopes transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.

registerHandlerBSX

public SimpleMessageListenerContainer registerHandlerBSX(ReplyHandler<BrokerStatus> handler,
                                                String inDstName,
                                                boolean isInDstTopic,
                                                String replyDstName,
                                                boolean isReplyDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). Replies to those messages are sent to the given reply destination (and of the given type). The handler is expected to operate on broker status messages transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

replyDstName - The reply destination name.

isReplyDstTopic - True if the reply destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.

registerHandlerBSX

public SimpleMessageListenerContainer registerHandlerBSX(ReceiveOnlyHandler<BrokerStatus> handler,
                                                String inDstName,
                                                boolean isInDstTopic)
                                                  throws JAXBException

Registers the given message handler for messages that are received by the given incoming destination (and of the given type). The handler is expected to operate on broker status messages transported using XML. Returns the Spring container of the handler (listener) for manual bean lifecycle management.

Parameters:

handler - The message handler.

inDstName - The incoming destination name.

isInDstTopic - True if the incoming destination is a topic.

Returns:

The container.

Throws:

JAXBException - Thrown if an error occurs in creating the JMS/XML converter.