de.taimos.dvalin.interconnect.core

Class MessageConnector

java.lang.Object

de.taimos.dvalin.interconnect.core.MessageConnector

public final class MessageConnector
extends Object

Connector to connect to JMS providers.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MSGPRIORITY the message priority to use when sending a message over the message queue
static long	REQUEST_TIMEOUT the default request timeout
static String	SYSPROP_IBROKERURL name of the system property that contains the interconnect broker URL
static String	SYSPROP_UPDATE_TOPIC name of the system property that contains the interconnect update topic name

Method Summary

Modifier and Type	Method and Description
static void	decryptMessage(javax.jms.TextMessage txt)
static boolean	isMessageSecure(javax.jms.TextMessage txt)
static javax.jms.TextMessage	receive(String queueName, String selector, long timeout, boolean secure) Deprecated. use receiveFromQueue instead
static List<javax.jms.TextMessage>	receiveBulkFromQueue(String queueName, String selector, int maxSize, long timeout, boolean secure)
static List<javax.jms.TextMessage>	receiveBulkFromTopic(String topicName, String selector, int maxSize, long timeout, boolean secure)
static javax.jms.TextMessage	receiveFromQueue(String queueName, String selector, long timeout, boolean secure)
static javax.jms.TextMessage	receiveFromTopic(String topicName, String selector, long timeout, boolean secure)
static javax.jms.TextMessage	request(String queueName, String body, Map<String,Object> headers)
static javax.jms.TextMessage	request(String queueName, String body, Map<String,Object> headers, boolean secure, long receiveTimeout, long sendTimeout, int priority)
static void	secureMessage(javax.jms.TextMessage txt)
static void	sendToDestination(javax.jms.Destination destination, String body, Map<String,Object> headers, boolean secure, String replyToQueueName, String correlationId)
static void	sendToQueue(String queueName, String body, Map<String,Object> headers)
static void	sendToQueue(String queueName, String body, Map<String,Object> headers, boolean secure)
static void	sendToQueue(String queueName, String body, Map<String,Object> headers, boolean secure, String replyToQueueName, String correlationId)
static void	sendToQueue(String queueName, String body, Map<String,Object> headers, String replyToQueueName, String correlationId)
static void	sendToTopic(String topicName, String body, Map<String,Object> headers)
static void	sendToTopic(String topicName, String body, Map<String,Object> headers, boolean secure)
static void	start()
static void	start(String brokerUrl)
static void	stop()

Methods inherited from class java.lang.Object

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

Field Detail

SYSPROP_IBROKERURL

public static final String SYSPROP_IBROKERURL

name of the system property that contains the interconnect broker URL

See Also:

Constant Field Values

SYSPROP_UPDATE_TOPIC

public static final String SYSPROP_UPDATE_TOPIC

name of the system property that contains the interconnect update topic name

See Also:

Constant Field Values

REQUEST_TIMEOUT

public static final long REQUEST_TIMEOUT

the default request timeout

See Also:

Constant Field Values

MSGPRIORITY

public static final int MSGPRIORITY

the message priority to use when sending a message over the message queue

See Also:

Constant Field Values

Method Detail

start

public static void start()
                  throws InfrastructureException

Throws:

InfrastructureException - of connection error

start

public static void start(String brokerUrl)
                  throws InfrastructureException

Parameters:

brokerUrl - the URL of the Interconnect message broker

Throws:

InfrastructureException - of connection error

stop

public static void stop()
                 throws InfrastructureException

Throws:

InfrastructureException - on disconnect error

sendToDestination

public static void sendToDestination(javax.jms.Destination destination,
                                     String body,
                                     Map<String,Object> headers,
                                     boolean secure,
                                     String replyToQueueName,
                                     String correlationId)
                              throws InfrastructureException,
                                     CryptoException

Parameters:

destination - the destination

body - the request body as String

headers - the request headers

secure - enable secure transport

replyToQueueName - the name of the queue to reply to or null

correlationId - the correlated id

Throws:

InfrastructureException - on errors

CryptoException - on secure transport errors

sendToQueue

public static void sendToQueue(String queueName,
                               String body,
                               Map<String,Object> headers,
                               boolean secure,
                               String replyToQueueName,
                               String correlationId)
                        throws InfrastructureException,
                               CryptoException

Parameters:

queueName - the name of the queue

body - the request body as String

headers - the request headers

secure - enable secure transport

replyToQueueName - the name of the queue to reply to or null

correlationId - the correlated id

Throws:

InfrastructureException - on errors

CryptoException - on secure transport errors

sendToQueue

public static void sendToQueue(String queueName,
                               String body,
                               Map<String,Object> headers,
                               boolean secure)
                        throws InfrastructureException,
                               CryptoException

Parameters:

queueName - the name of the queue

body - the request body as String

headers - the request headers

secure - enable secure transport

Throws:

InfrastructureException - on errors

CryptoException - on secure transport errors

sendToQueue

public static void sendToQueue(String queueName,
                               String body,
                               Map<String,Object> headers,
                               String replyToQueueName,
                               String correlationId)
                        throws InfrastructureException

Parameters:

queueName - the name of the queue

body - the request body as String

headers - the request headers

replyToQueueName - the name of the queue to reply to or null

correlationId - the correlated id

Throws:

InfrastructureException - on errors

sendToQueue

public static void sendToQueue(String queueName,
                               String body,
                               Map<String,Object> headers)
                        throws InfrastructureException

Parameters:

queueName - the name of the queue

body - the request body as String

headers - the request headers

Throws:

InfrastructureException - on errors

sendToTopic

public static void sendToTopic(String topicName,
                               String body,
                               Map<String,Object> headers,
                               boolean secure)
                        throws InfrastructureException,
                               CryptoException

Parameters:

topicName - the name of the topic

body - the request body as String

headers - the request headers

secure - enable secure transport

Throws:

InfrastructureException - on errors

CryptoException - on secure transport errors

sendToTopic

public static void sendToTopic(String topicName,
                               String body,
                               Map<String,Object> headers)
                        throws InfrastructureException

Parameters:

topicName - the name of the topic

body - the request body as String

headers - the request headers

Throws:

InfrastructureException - on errors

receive

@Deprecated
public static javax.jms.TextMessage receive(String queueName,
                                                        String selector,
                                                        long timeout,
                                                        boolean secure)
                                                 throws InfrastructureException,
                                                        CryptoException

Deprecated. use receiveFromQueue instead

Parameters:

queueName - the name of the request queue

selector - the JMS selector (null or an empty string indicates that there is no selector)

timeout - the request timeout

secure - enable secure transport

Returns:

the received TextMessage

Throws:

InfrastructureException - on errors

CryptoException - on crypto errors

receiveFromQueue

public static javax.jms.TextMessage receiveFromQueue(String queueName,
                                                     String selector,
                                                     long timeout,
                                                     boolean secure)
                                              throws InfrastructureException,
                                                     CryptoException

Parameters:

queueName - the name of the request queue

selector - the JMS selector (null or an empty string indicates that there is no selector)

timeout - the request timeout

secure - enable secure transport

Returns:

the received TextMessage

Throws:

InfrastructureException - on errors

CryptoException - on crypto errors

receiveBulkFromQueue

public static List<javax.jms.TextMessage> receiveBulkFromQueue(String queueName,
                                                               String selector,
                                                               int maxSize,
                                                               long timeout,
                                                               boolean secure)
                                                        throws InfrastructureException,
                                                               CryptoException

Parameters:

queueName - the name of the request queue

selector - the JMS selector (null or an empty string indicates that there is no selector)

maxSize - Max messages to receive

timeout - the request timeout

secure - enable secure transport

Returns:

the received TextMessages

Throws:

InfrastructureException - on errors

CryptoException - on crypto errors

receiveFromTopic

public static javax.jms.TextMessage receiveFromTopic(String topicName,
                                                     String selector,
                                                     long timeout,
                                                     boolean secure)
                                              throws InfrastructureException,
                                                     CryptoException

Parameters:

topicName - the name of the topic

selector - the JMS selector (null or an empty string indicates that there is no selector)

timeout - the request timeout

secure - enable secure transport

Returns:

the received TextMessage

Throws:

InfrastructureException - on errors

CryptoException - on crypto errors

receiveBulkFromTopic

public static List<javax.jms.TextMessage> receiveBulkFromTopic(String topicName,
                                                               String selector,
                                                               int maxSize,
                                                               long timeout,
                                                               boolean secure)
                                                        throws InfrastructureException,
                                                               CryptoException

Parameters:

topicName - the name of the topic

selector - the JMS selector (null or an empty string indicates that there is no selector)

maxSize - Max messages to receive

timeout - the request timeout

secure - enable secure transport

Returns:

the received TextMessages

Throws:

InfrastructureException - on errors

CryptoException - on crypto errors

request

public static javax.jms.TextMessage request(String queueName,
                                            String body,
                                            Map<String,Object> headers,
                                            boolean secure,
                                            long receiveTimeout,
                                            long sendTimeout,
                                            int priority)
                                     throws InfrastructureException,
                                            CryptoException

Parameters:

queueName - the name of the request queue

body - the request body as String

headers - the request headers

secure - enable secure transport

receiveTimeout - the request timeout

sendTimeout - the send timeout

priority - the message priority

Returns:

the response TextMessage

Throws:

InfrastructureException - on errors

CryptoException - on secure transport errors

request

public static javax.jms.TextMessage request(String queueName,
                                            String body,
                                            Map<String,Object> headers)
                                     throws InfrastructureException

Parameters:

queueName - the name of the request queue

body - the request body as String

headers - the request headers

Returns:

the response TextMessage

Throws:

InfrastructureException - on errors

isMessageSecure

public static boolean isMessageSecure(javax.jms.TextMessage txt)
                               throws CryptoException,
                                      InfrastructureException

Parameters:

txt - the message to encrypt

Throws:

CryptoException - on crypto errors

InfrastructureException

decryptMessage

public static void decryptMessage(javax.jms.TextMessage txt)
                           throws CryptoException

Parameters:

txt - the message to encrypt

Throws:

CryptoException - on crypto errors

secureMessage

public static void secureMessage(javax.jms.TextMessage txt)
                          throws javax.jms.JMSException,
                                 CryptoException

Parameters:

txt - the message to encrypt

Throws:

javax.jms.JMSException - on JMS errors

CryptoException - on crypto errors