org.mule.jms.commons.internal.support

Class Jms20Support

java.lang.Object

org.mule.jms.commons.internal.support.Jms20Support

All Implemented Interfaces:

JmsSupport

Direct Known Subclasses:

Jms11Support

public class Jms20Support
extends Object
implements JmsSupport

Jms20Support is a template class to provide an abstraction to to the JMS 2.0 API specification.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
Jms20Support()
Jms20Support(LookupJndiDestination lookupJndiDestination, Function<String,Optional<javax.jms.Destination>> jndiObjectSupplier)

Method Summary

Modifier and Type	Method and Description
javax.jms.Connection	createConnection(javax.jms.ConnectionFactory connectionFactory) Creates a new Connection
javax.jms.Connection	createConnection(javax.jms.ConnectionFactory connectionFactory, String username, String password) Creates a new Connection with custom user/password authentication
javax.jms.MessageConsumer	createConsumer(javax.jms.Session session, javax.jms.Destination destination, String messageSelector, ConsumerType type) Creates a new JMS MessageConsumer using the given Session
javax.jms.Destination	createDestination(javax.jms.Session session, String name, boolean topic, JmsConfig config) Creates a new JMS Destination with the given name.
protected Optional<javax.jms.Destination>	createDestinationFromJndi(String name)
javax.jms.MessageProducer	createProducer(javax.jms.Session session, javax.jms.Destination destination, boolean topic) Creates a new JMS MessageProducer using the given Session
javax.jms.Session	createSession(javax.jms.Connection connection, boolean topic, boolean transacted, int ackMode) Creates a new Session for the given Connection
javax.jms.TemporaryQueue	createTemporaryDestination(javax.jms.Session session) Creates an anonymous temporary Queue Destination
javax.jms.XAConnection	createXaConnection(javax.jms.XAConnectionFactory connectionFactory) Creates a new XAConnection
javax.jms.XAConnection	createXaConnection(javax.jms.XAConnectionFactory connectionFactory, String username, String password) Creates a new XAConnection
javax.jms.XASession	createXaSession(javax.jms.XAConnection connection) Creates a new Session for the given Connection
protected Optional<javax.jms.Destination>	getJndiDestination(String name)
protected LookupJndiDestination	getLookupJndiDestination()
JmsSpecification	getSpecification()
void	send(javax.jms.MessageProducer producer, javax.jms.Message message, boolean persistent, int priority, long ttl, boolean topic) Sends the given Message to the indicated Destination using the parametrized configurations
void	send(javax.jms.MessageProducer producer, javax.jms.Message message, boolean persistent, int priority, long ttl, boolean topic, javax.jms.CompletionListener completionListener) Sends the given Message to the indicated Destination using the parametrized configurations in a async way.

Methods inherited from class java.lang.Object

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

Constructor Detail

Jms20Support

public Jms20Support()

Jms20Support

public Jms20Support(LookupJndiDestination lookupJndiDestination,
                    Function<String,Optional<javax.jms.Destination>> jndiObjectSupplier)

Method Detail

getSpecification

public JmsSpecification getSpecification()

Specified by:

getSpecification in interface JmsSupport

Returns:

this implementation JmsSpecification

createConnection

public javax.jms.Connection createConnection(javax.jms.ConnectionFactory connectionFactory,
                                             String username,
                                             String password)
                                      throws javax.jms.JMSException

Creates a new Connection with custom user/password authentication

Specified by:

createConnection in interface JmsSupport

Parameters:

connectionFactory - the ConnectionFactory to use for creating the Connection

username - the credentials username

password - the credentials password

Returns:

a new Connection

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createXaConnection

public javax.jms.XAConnection createXaConnection(javax.jms.XAConnectionFactory connectionFactory)
                                          throws javax.jms.JMSException

Creates a new XAConnection

Specified by:

createXaConnection in interface JmsSupport

Parameters:

connectionFactory - the XAConnectionFactory to use for creating the XAConnection

Returns:

a new Connection

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createXaConnection

public javax.jms.XAConnection createXaConnection(javax.jms.XAConnectionFactory connectionFactory,
                                                 String username,
                                                 String password)
                                          throws javax.jms.JMSException

Creates a new XAConnection

Specified by:

createXaConnection in interface JmsSupport

Parameters:

connectionFactory - the XAConnectionFactory to use for creating the XAConnection

Returns:

a new Connection

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createConnection

public javax.jms.Connection createConnection(javax.jms.ConnectionFactory connectionFactory)
                                      throws javax.jms.JMSException

Creates a new Connection

Specified by:

createConnection in interface JmsSupport

Parameters:

connectionFactory - the ConnectionFactory to use for creating the Connection

Returns:

a new Connection

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createSession

public javax.jms.Session createSession(javax.jms.Connection connection,
                                       boolean topic,
                                       boolean transacted,
                                       int ackMode)
                                throws javax.jms.JMSException

Creates a new Session for the given Connection

Specified by:

createSession in interface JmsSupport

Parameters:

connection - the Connection to use for creating the Session

topic - if true the Session created will be a TopicSession. This distinction is made only for JmsSpecification.JMS_1_0_2b

transacted - indicates whether the session will use a local transaction

ackMode - the Session InternalAckMode

Returns:

a new Session

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createXaSession

public javax.jms.XASession createXaSession(javax.jms.XAConnection connection)
                                    throws javax.jms.JMSException

Description copied from interface: JmsSupport

Creates a new Session for the given Connection

Specified by:

createXaSession in interface JmsSupport

Parameters:

connection - the XAConnection to use for creating the XASession

Returns:

a new XASession

Throws:

javax.jms.JMSException - if an error occurs during connection creation

createProducer

public javax.jms.MessageProducer createProducer(javax.jms.Session session,
                                                javax.jms.Destination destination,
                                                boolean topic)
                                         throws javax.jms.JMSException

Creates a new JMS MessageProducer using the given Session

Specified by:

createProducer in interface JmsSupport

Parameters:

session - the Session used to create the MessageProducer

destination - the Destination to where the Messages will be published

topic - if true the given Destination has a Topic destination type. This distinction is made only for JmsSpecification.JMS_1_0_2b in order to decide whether to create a TopicPublisher or a QueueSender

Returns:

a new MessageProducer for the given Destination

Throws:

javax.jms.JMSException - if an error occurs while creating the consumer

createConsumer

public javax.jms.MessageConsumer createConsumer(javax.jms.Session session,
                                                javax.jms.Destination destination,
                                                String messageSelector,
                                                ConsumerType type)
                                         throws javax.jms.JMSException

Creates a new JMS MessageConsumer using the given Session

Specified by:

createConsumer in interface JmsSupport

Parameters:

session - the Session used to create the MessageConsumer

destination - the Destination from which Messages will be consumed

messageSelector - a JMS selector string for filtering incoming Messages. Empty or null implies no filtering

type - the ConsumerType to use based on the Destination type

Returns:

a new MessageConsumer for the given Destination

Throws:

javax.jms.JMSException - if an error occurs while creating the consumer

createDestination

public javax.jms.Destination createDestination(javax.jms.Session session,
                                               String name,
                                               boolean topic,
                                               JmsConfig config)
                                        throws javax.jms.JMSException,
                                               DestinationNotFoundException

Creates a new JMS Destination with the given name. If LookupJndiDestination.ALWAYS or LookupJndiDestination.TRY_ALWAYS where configured, this name will be used for performing the JNDI lookup

Specified by:

createDestination in interface JmsSupport

Parameters:

session - the Session used to create the Destination

name - the name of the destination

topic - if true, a Topic Destination will be created, otherwise the Queue default is used

Returns:

a new Destination

Throws:

javax.jms.JMSException - if an error occurs during the creation of the destination

DestinationNotFoundException - if LookupJndiDestination.ALWAYS is configured and no Destination with the given name is found

createDestinationFromJndi

protected Optional<javax.jms.Destination> createDestinationFromJndi(String name)
                                                             throws javax.jms.JMSException

Throws:

javax.jms.JMSException

getJndiDestination

protected Optional<javax.jms.Destination> getJndiDestination(String name)

createTemporaryDestination

public javax.jms.TemporaryQueue createTemporaryDestination(javax.jms.Session session)
                                                    throws javax.jms.JMSException

Creates an anonymous temporary Queue Destination

Specified by:

createTemporaryDestination in interface JmsSupport

Parameters:

session - the Session used to create the Destination

Returns:

a new temporary Queue Destination

Throws:

javax.jms.JMSException - if an error occurs during destination creation

send

public void send(javax.jms.MessageProducer producer,
                 javax.jms.Message message,
                 boolean persistent,
                 int priority,
                 long ttl,
                 boolean topic)
          throws javax.jms.JMSException

Sends the given Message to the indicated Destination using the parametrized configurations

Specified by:

send in interface JmsSupport

Parameters:

producer - the MessageProducer to use for sending the message

message - the Message to send

persistent - true if DeliveryMode.PERSISTENT should be used

priority - the Message.getJMSPriority() to be set on send

ttl - the message's lifetime (in milliseconds)

topic - used by JmsSpecification.JMS_1_0_2b to decide whether to use the MessageProducer as TopicPublisher or a QueueSender

Throws:

javax.jms.JMSException - if an error occurs during messsage sending

send

public void send(javax.jms.MessageProducer producer,
                 javax.jms.Message message,
                 boolean persistent,
                 int priority,
                 long ttl,
                 boolean topic,
                 javax.jms.CompletionListener completionListener)
          throws javax.jms.JMSException

Sends the given Message to the indicated Destination using the parametrized configurations in a async way.

Specified by:

send in interface JmsSupport

Parameters:

producer - the MessageProducer to use for sending the message

message - the Message to send

persistent - true if DeliveryMode.PERSISTENT should be used

priority - the Message.getJMSPriority() to be set on send

ttl - the message's lifetime (in milliseconds)

topic - used by JmsSpecification.JMS_1_0_2b to decide whether to use the MessageProducer as TopicPublisher or a QueueSender

Throws:

javax.jms.JMSException - if an error occurs during messsage sending

getLookupJndiDestination

protected LookupJndiDestination getLookupJndiDestination()