org.mule.transport.jms

Class JmsConnector

java.lang.Object

org.mule.transport.AbstractConnector

org.mule.transport.jms.JmsConnector

All Implemented Interfaces:

ExceptionListener, EventListener, javax.resource.spi.work.WorkListener, MuleContextAware, ConnectionNotificationListener, ServerNotificationListener, Disposable, Initialisable, Lifecycle, Startable, Stoppable, NamedObject, Connectable, Connector

Direct Known Subclasses:

ActiveMQJmsConnector, WeblogicJmsConnector, WebsphereJmsConnector

public class JmsConnector
extends AbstractConnector
implements ConnectionNotificationListener

JmsConnector is a JMS 1.0.2b compliant connector that can be used by a Mule endpoint. The connector supports all JMS functionality including topics and queues, durable subscribers, acknowledgement modes and local transactions.

Field Summary

Fields

Modifier and Type	Field and Description
static String	JMS
String	password
String	username

Fields inherited from class org.mule.transport.AbstractConnector

connected, connectedSemaphore, connecting, connectionStrategy, createMultipleTransactedReceivers, DEFAULT_NUM_CONCURRENT_TX_RECEIVERS, dispatcherFactory, dispatchers, disposed, disposing, exceptionListener, initialised, logger, muleContext, name, numberOfConcurrentTransactedReceivers, receivers, requesterFactory, requesters, serviceDescriptor, serviceOverrides, sessionHandler, started, startOnConnect

Fields inherited from interface org.mule.api.transport.Connector

INT_VALUE_NOT_SET

Fields inherited from interface org.mule.api.lifecycle.Initialisable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Startable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Stoppable

PHASE_NAME

Fields inherited from interface org.mule.api.lifecycle.Disposable

PHASE_NAME

Constructor Summary

Constructors

Constructor and Description
JmsConnector()

Method Summary

Methods

Modifier and Type	Method and Description
void	close(javax.jms.MessageConsumer consumer) Closes the MessageConsumer
void	close(javax.jms.MessageProducer producer) Closes the MessageProducer
void	close(javax.jms.Session session) Closes the MuleSession
void	close(javax.jms.TemporaryQueue tempQueue) Closes the TemporaryQueue
void	close(javax.jms.TemporaryTopic tempTopic) Closes the TemporaryTopic
void	closeQuietly(javax.jms.MessageConsumer consumer) Closes the MessageConsumer without throwing an exception (an error message is logged instead).
void	closeQuietly(javax.jms.MessageProducer producer) Closes the MessageProducer without throwing an exception (an error message is logged instead).
void	closeQuietly(javax.jms.Session session) Closes the MuleSession without throwing an exception (an error message is logged instead).
void	closeQuietly(javax.jms.TemporaryQueue tempQueue) Closes the TemporaryQueue without throwing an exception (an error message is logged instead).
void	closeQuietly(javax.jms.TemporaryTopic tempTopic) Closes the TemporaryTopic without throwing an exception (an error message is logged instead).
protected javax.jms.Connection	createConnection()
protected void	doConnect() Template method where any connections should be made for the connector
protected void	doDisconnect() Template method where any connected resources used by the connector should be disconnected
protected void	doDispose() Template method to perform any work when destroying the connectoe
protected void	doInitialise()
protected void	doStart() Template method to perform any work when starting the connectoe
protected void	doStop() Template method to perform any work when stopping the connectoe
int	getAcknowledgementMode()
String	getClientId()
javax.jms.Connection	getConnection()
javax.jms.ConnectionFactory	getConnectionFactory()
ConnectionStrategy	getConnectionStrategy() Getter for property 'connectionStrategy'.
protected javax.jms.ConnectionFactory	getDefaultConnectionFactory() Override this method to provide a default ConnectionFactory for a vendor-specific JMS Connector.
JmsSupport	getJmsSupport()
int	getMaxRedelivery()
MessageAdapter	getMessageAdapter(Object message) Gets a MessageAdapter for the endpoint for the given message (data)
String	getPassword()
String	getProtocol()
protected Object	getReceiverKey(Service service, InboundEndpoint endpoint) The method determines the key used to store the receiver against.
RedeliveryHandlerFactory	getRedeliveryHandlerFactory()
ReplyToHandler	getReplyToHandler() Getter for property 'replyToHandler'.
javax.jms.Session	getSession(boolean transacted, boolean topic)
javax.jms.Session	getSession(ImmutableEndpoint endpoint)
javax.jms.Session	getSessionFromTransaction()
String	getSpecification()
JmsTopicResolver	getTopicResolver() Getter for property 'topicResolver'.
String	getUsername()
boolean	isCacheJmsSessions()
boolean	isDurable()
boolean	isEagerConsumer() Getter for property 'eagerConsumer'.
boolean	isHonorQosHeaders() Gets the value of honorQosHeaders property.
boolean	isNoLocal()
boolean	isPersistentDelivery()
boolean	isRecoverJmsConnections()
boolean	isRemoteSyncEnabled()
void	onNotification(ServerNotification notification)
javax.jms.Message	preProcessMessage(javax.jms.Message message, javax.jms.Session session) This method may be overridden in order to apply pre-processing to the message as soon as it arrives.
void	setAcknowledgementMode(int acknowledgementMode)
void	setCacheJmsSessions(boolean cacheJmsSessions)
void	setClientId(String clientId)
protected void	setConnection(javax.jms.Connection connection)
void	setConnectionFactory(javax.jms.ConnectionFactory connectionFactory)
void	setDurable(boolean durable)
void	setEagerConsumer(boolean eagerConsumer) A value of true will create a consumer on connect, in contrast to lazy instantiation in the poll loop.
void	setHonorQosHeaders(boolean honorQosHeaders) Sets the honorQosHeaders property, which determines whether JmsMessageDispatcher should honor incoming message's QoS headers (JMSPriority, JMSDeliveryMode).
void	setJmsSupport(JmsSupport jmsSupport)
void	setMaxRedelivery(int maxRedelivery)
void	setNoLocal(boolean noLocal)
void	setPassword(String password)
void	setPersistentDelivery(boolean persistentDelivery)
void	setRecoverJmsConnections(boolean recover)
void	setRedeliveryHandlerFactory(RedeliveryHandlerFactory redeliveryHandlerFactory)
void	setSpecification(String specification)
void	setTopicResolver(JmsTopicResolver topicResolver) Setter for property 'topicResolver'.
void	setUsername(String username)
boolean	supportsProperty(String property) This method may be overridden in case a certain JMS implementation does not support all the standard JMS properties.

Methods inherited from class org.mule.transport.AbstractConnector

checkDisposed, connect, createReceiver, destroyReceiver, disconnect, dispatch, dispose, disposeDispatchers, disposeReceivers, disposeRequesters, disposeWorkManagers, exceptionThrown, fireNotification, getConnectedSemaphore, getConnectEventId, getConnectionDescription, getDefaultInboundTransformers, getDefaultOutboundTransformers, getDefaultResponseTransformers, getDispatcherFactory, getDispatcherThreadingProfile, getDispatcherWorkManager, getExceptionListener, getMaxDispatchersActive, getMaxRequestersActive, getMuleContext, getName, getNumberOfConcurrentTransactedReceivers, getOutputStream, getReceiver, getReceivers, getReceivers, getReceiverThreadingProfile, getReceiverWorkManager, getRequesterFactory, getRequesterThreadingProfile, getRequesterWorkManager, getScheduler, getServiceDescriptor, getServiceOverrides, getSessionHandler, getSupportedProtocols, handleException, handleWorkException, initFromServiceDescriptor, initialise, initialiseFromUrl, initWorkManagers, isConnected, isCreateMultipleTransactedReceivers, isDisposed, isDisposing, isEnableMessageEvents, isStarted, isSyncEnabled, lookupReceiver, registerListener, registerSupportedProtocol, registerSupportedProtocolWithoutPrefix, request, request, send, setConnectionStrategy, setCreateMultipleTransactedReceivers, setDispatcherFactory, setDispatcherThreadingProfile, setDynamicNotification, setExceptionListener, setMaxDispatchersActive, setMaxRequestersActive, setMuleContext, setName, setNumberOfConcurrentTransactedReceivers, setReceiverThreadingProfile, setRequesterFactory, setRequesterThreadingProfile, setServiceOverrides, setSessionHandler, setSupportedProtocols, setupDispatchReturn, setupRequestReturn, start, stop, supportsProtocol, toString, unregisterListener, unregisterSupportedProtocol, updateCachedNotificationHandler, workAccepted, workCompleted, workRejected, workStarted

Methods inherited from class java.lang.Object

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

Field Detail

JMS

public static final String JMS

See Also:

Constant Field Values

username

public String username

password

public String password

Constructor Detail

JmsConnector

public JmsConnector()

Method Detail

getProtocol

public String getProtocol()

Specified by:

getProtocol in interface Connector

Returns:

the primary protocol name for endpoints of this connector

doInitialise

protected void doInitialise()
                     throws InitialisationException

Specified by:

doInitialise in class AbstractConnector

Throws:

InitialisationException

getDefaultConnectionFactory

protected javax.jms.ConnectionFactory getDefaultConnectionFactory()

Override this method to provide a default ConnectionFactory for a vendor-specific JMS Connector.

doDispose

protected void doDispose()

Description copied from class: AbstractConnector

Template method to perform any work when destroying the connectoe

Specified by:

doDispose in class AbstractConnector

createConnection

protected javax.jms.Connection createConnection()
                                         throws NamingException,
                                                javax.jms.JMSException,
                                                InitialisationException

Throws:

NamingException

javax.jms.JMSException

InitialisationException

doConnect

protected void doConnect()
                  throws ConnectException

Description copied from class: AbstractConnector

Template method where any connections should be made for the connector

Specified by:

doConnect in class AbstractConnector

Throws:

ConnectException

doDisconnect

protected void doDisconnect()
                     throws ConnectException

Description copied from class: AbstractConnector

Template method where any connected resources used by the connector should be disconnected

Specified by:

doDisconnect in class AbstractConnector

Throws:

ConnectException

getMessageAdapter

public MessageAdapter getMessageAdapter(Object message)
                                 throws MessagingException

Description copied from class: AbstractConnector

Gets a MessageAdapter for the endpoint for the given message (data)

Specified by:

getMessageAdapter in interface Connector

Overrides:

getMessageAdapter in class AbstractConnector

Parameters:

message - the data with which to initialise the MessageAdapter

Returns:

the MessageAdapter for the endpoint

Throws:

MessagingException - if the message parameter is not supported

See Also:

MessageAdapter

getReceiverKey

protected Object getReceiverKey(Service service,
                    InboundEndpoint endpoint)

Description copied from class: AbstractConnector

The method determines the key used to store the receiver against.

Overrides:

getReceiverKey in class AbstractConnector

Parameters:

service - the service for which the endpoint is being registered

endpoint - the endpoint being registered for the service

Returns:

the key to store the newly created receiver against

getSessionFromTransaction

public javax.jms.Session getSessionFromTransaction()

getSession

public javax.jms.Session getSession(ImmutableEndpoint endpoint)
                             throws javax.jms.JMSException

Throws:

javax.jms.JMSException

getSession

public javax.jms.Session getSession(boolean transacted,
                           boolean topic)
                             throws javax.jms.JMSException

Throws:

javax.jms.JMSException

doStart

protected void doStart()
                throws MuleException

Description copied from class: AbstractConnector

Template method to perform any work when starting the connectoe

Specified by:

doStart in class AbstractConnector

Throws:

MuleException - if the method fails

doStop

protected void doStop()
               throws MuleException

Description copied from class: AbstractConnector

Template method to perform any work when stopping the connectoe

Specified by:

doStop in class AbstractConnector

Throws:

MuleException - if the method fails

getReplyToHandler

public ReplyToHandler getReplyToHandler()

Description copied from class: AbstractConnector

Getter for property 'replyToHandler'.

Overrides:

getReplyToHandler in class AbstractConnector

Returns:

Value for property 'replyToHandler'.

onNotification

public void onNotification(ServerNotification notification)

Specified by:

onNotification in interface ServerNotificationListener

supportsProperty

public boolean supportsProperty(String property)

This method may be overridden in case a certain JMS implementation does not support all the standard JMS properties.

preProcessMessage

public javax.jms.Message preProcessMessage(javax.jms.Message message,
                                  javax.jms.Session session)
                                    throws Exception

This method may be overridden in order to apply pre-processing to the message as soon as it arrives.

Parameters:

message - - the incoming message

session - - the JMS session

Returns:

the preprocessed message

Throws:

Exception

close

public void close(javax.jms.MessageProducer producer)
           throws javax.jms.JMSException

Closes the MessageProducer

Parameters:

producer -

Throws:

javax.jms.JMSException

closeQuietly

public void closeQuietly(javax.jms.MessageProducer producer)

Closes the MessageProducer without throwing an exception (an error message is logged instead).

Parameters:

producer -

close

public void close(javax.jms.MessageConsumer consumer)
           throws javax.jms.JMSException

Closes the MessageConsumer

Parameters:

consumer -

Throws:

javax.jms.JMSException

closeQuietly

public void closeQuietly(javax.jms.MessageConsumer consumer)

Closes the MessageConsumer without throwing an exception (an error message is logged instead).

Parameters:

consumer -

close

public void close(javax.jms.Session session)
           throws javax.jms.JMSException

Closes the MuleSession

Parameters:

session -

Throws:

javax.jms.JMSException

closeQuietly

public void closeQuietly(javax.jms.Session session)

Closes the MuleSession without throwing an exception (an error message is logged instead).

Parameters:

session -

close

public void close(javax.jms.TemporaryQueue tempQueue)
           throws javax.jms.JMSException

Closes the TemporaryQueue

Parameters:

tempQueue -

Throws:

javax.jms.JMSException

closeQuietly

public void closeQuietly(javax.jms.TemporaryQueue tempQueue)

Closes the TemporaryQueue without throwing an exception (an error message is logged instead).

Parameters:

tempQueue -

close

public void close(javax.jms.TemporaryTopic tempTopic)
           throws javax.jms.JMSException

Closes the TemporaryTopic

Parameters:

tempTopic -

Throws:

javax.jms.JMSException

closeQuietly

public void closeQuietly(javax.jms.TemporaryTopic tempTopic)

Closes the TemporaryTopic without throwing an exception (an error message is logged instead).

Parameters:

tempTopic -

getConnection

public javax.jms.Connection getConnection()

Returns:

Returns the connection.

setConnection

protected void setConnection(javax.jms.Connection connection)

getAcknowledgementMode

public int getAcknowledgementMode()

Returns:

Returns the acknowledgeMode.

setAcknowledgementMode

public void setAcknowledgementMode(int acknowledgementMode)

Parameters:

acknowledgementMode - The acknowledgementMode to set.

isDurable

public boolean isDurable()

Returns:

Returns the durable.

setDurable

public void setDurable(boolean durable)

Parameters:

durable - The durable to set.

isNoLocal

public boolean isNoLocal()

Returns:

Returns the noLocal.

setNoLocal

public void setNoLocal(boolean noLocal)

Parameters:

noLocal - The noLocal to set.

isPersistentDelivery

public boolean isPersistentDelivery()

Returns:

Returns the persistentDelivery.

setPersistentDelivery

public void setPersistentDelivery(boolean persistentDelivery)

Parameters:

persistentDelivery - The persistentDelivery to set.

getJmsSupport

public JmsSupport getJmsSupport()

setJmsSupport

public void setJmsSupport(JmsSupport jmsSupport)

getSpecification

public String getSpecification()

setSpecification

public void setSpecification(String specification)

setRecoverJmsConnections

public void setRecoverJmsConnections(boolean recover)

isRecoverJmsConnections

public boolean isRecoverJmsConnections()

getUsername

public String getUsername()

setUsername

public void setUsername(String username)

getPassword

public String getPassword()

setPassword

public void setPassword(String password)

getClientId

public String getClientId()

setClientId

public void setClientId(String clientId)

getMaxRedelivery

public int getMaxRedelivery()

setMaxRedelivery

public void setMaxRedelivery(int maxRedelivery)

isRemoteSyncEnabled

public boolean isRemoteSyncEnabled()

Specified by:

isRemoteSyncEnabled in interface Connector

Overrides:

isRemoteSyncEnabled in class AbstractConnector

getTopicResolver

public JmsTopicResolver getTopicResolver()

Getter for property 'topicResolver'.

Returns:

Value for property 'topicResolver'.

setTopicResolver

public void setTopicResolver(JmsTopicResolver topicResolver)

Setter for property 'topicResolver'.

Parameters:

topicResolver - Value to set for property 'topicResolver'.

isEagerConsumer

public boolean isEagerConsumer()

Getter for property 'eagerConsumer'. Default is true.

Returns:

Value for property 'eagerConsumer'.

See Also:

eagerConsumer

setEagerConsumer

public void setEagerConsumer(boolean eagerConsumer)

A value of true will create a consumer on connect, in contrast to lazy instantiation in the poll loop. This setting very much depends on the JMS vendor. Affects transactional receivers, typical symptoms are:

• consumer thread hanging forever, though a message is available
• failure to consume the first message (the rest are fine)

Parameters:

eagerConsumer - Value to set for property 'eagerConsumer'.

See Also:

eagerConsumer, XaTransactedJmsMessageReceiver

isCacheJmsSessions

public boolean isCacheJmsSessions()

setCacheJmsSessions

public void setCacheJmsSessions(boolean cacheJmsSessions)

getConnectionFactory

public javax.jms.ConnectionFactory getConnectionFactory()

setConnectionFactory

public void setConnectionFactory(javax.jms.ConnectionFactory connectionFactory)

getRedeliveryHandlerFactory

public RedeliveryHandlerFactory getRedeliveryHandlerFactory()

setRedeliveryHandlerFactory

public void setRedeliveryHandlerFactory(RedeliveryHandlerFactory redeliveryHandlerFactory)

setHonorQosHeaders

public void setHonorQosHeaders(boolean honorQosHeaders)

Sets the honorQosHeaders property, which determines whether JmsMessageDispatcher should honor incoming message's QoS headers (JMSPriority, JMSDeliveryMode).

Parameters:

honorQosHeaders - true if JmsMessageDispatcher should honor incoming message's QoS headers; otherwise false Default is false, meaning that connector settings will override message headers.

isHonorQosHeaders

public boolean isHonorQosHeaders()

Gets the value of honorQosHeaders property.

Returns:

true if JmsMessageDispatcher should honor incoming message's QoS headers; otherwise false Default is false, meaning that connector settings will override message headers.

getConnectionStrategy

public ConnectionStrategy getConnectionStrategy()

Description copied from class: AbstractConnector

Getter for property 'connectionStrategy'.

Overrides:

getConnectionStrategy in class AbstractConnector

Returns:

Value for property 'connectionStrategy'.