Package org.apache.activemq

Class ActiveMQXAConnection

java.lang.Object

org.apache.activemq.ActiveMQConnection

org.apache.activemq.ActiveMQXAConnection

All Implemented Interfaces:

jakarta.jms.Connection, jakarta.jms.QueueConnection, jakarta.jms.TopicConnection, jakarta.jms.XAConnection, jakarta.jms.XAQueueConnection, jakarta.jms.XATopicConnection, AutoCloseable, Closeable, EnhancedConnection, StatsCapable, TransportListener

public class ActiveMQXAConnection
extends ActiveMQConnection
implements jakarta.jms.XATopicConnection, jakarta.jms.XAQueueConnection, jakarta.jms.XAConnection

The XAConnection interface extends the capability of Connection by providing an XASession (optional).

The XAConnection interface is optional. JMS providers are not required to support this interface. This interface is for use by JMS providers to support transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.

See Also:

• Connection
• ConnectionFactory
• QueueConnection
• TopicConnection
• TopicConnectionFactory
• QueueConnection
• QueueConnectionFactory

Field Summary

Fields inherited from class org.apache.activemq.ActiveMQConnection

activeTempDestinations, alwaysSessionAsync, DEFAULT_BROKER_URL, DEFAULT_PASSWORD, DEFAULT_THREAD_POOL_SIZE, DEFAULT_USER, dispatchAsync, transportInterruptionProcessingComplete

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ActiveMQXAConnection(Transport transport, IdGenerator clientIdGenerator, IdGenerator connectionIdGenerator, JMSStatsImpl factoryStats)

Method Summary

Modifier and Type	Method	Description
jakarta.jms.Session	createSession(boolean transacted, int acknowledgeMode)	Creates a Session object.
jakarta.jms.XAQueueSession	createXAQueueSession()
jakarta.jms.XASession	createXASession()
jakarta.jms.XATopicSession	createXATopicSession()
int	getXaAckMode()
void	setXaAckMode(int xaAckMode)

Methods inherited from class org.apache.activemq.ActiveMQConnection

addConnectionConsumer, addDispatcher, addProducer, addSession, addTransportListener, asyncSendPacket, changeUserInfo, checkClientIDWasManuallySpecified, checkClosed, checkClosedOrFailed, cleanup, cleanUpTempDestinations, close, createBlobTransferPolicy, createConnectionConsumer, createConnectionConsumer, createConnectionConsumer, createConnectionConsumer, createDurableConnectionConsumer, createDurableConnectionConsumer, createQueueSession, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, createTempDestination, createTopicSession, deleteTempDestination, destroyDestination, doCleanup, ensureConnectionInfoSent, getBlobTransferPolicy, getBrokerInfo, getBrokerName, getClientID, getClientInternalExceptionListener, getCloseTimeout, getConnectionInfo, getConnectionStats, getConnectResponseTimeout, getConsumerFailoverRedeliveryWaitPeriod, getDestinationSource, getExceptionListener, getExecutor, getFirstFailureError, getInitializedClientID, getLocalTransactionIdGenerator, getMaxThreadPoolSize, getMetaData, getNextSessionId, getOptimizeAcknowledgeTimeOut, getOptimizedAckScheduledAckInterval, getPrefetchPolicy, getProducerWindowSize, getProtocolVersion, getRedeliveryPolicy, getRedeliveryPolicyMap, getRejectedTaskHandler, getResourceManagerId, getScheduler, getSendTimeout, getSessions, getSessionTaskRunner, getStats, getTimeCreated, getTransformer, getTransport, getTransportChannel, getTrustedPackages, getWarnAboutUnstartedConnectionTimeout, hasDispatcher, isAlwaysSessionAsync, isAlwaysSyncSend, isCheckForDuplicates, isClosed, isClosing, isConsumerExpiryCheckEnabled, isCopyMessageOnSend, isDeleted, isDisableTimeStampsByDefault, isDispatchAsync, isDuplicate, isExclusiveConsumer, isMessagePrioritySupported, isNestedMapAndListEnabled, isNonBlockingRedelivery, isObjectMessageSerializationDefered, isOptimizeAcknowledge, isOptimizedMessageDispatch, isRmIdFromConnectionId, isSendAcksAsync, isStarted, isStatsEnabled, isTransactedIndividualAck, isTransportFailed, isTrustAllPackages, isUseAsyncSend, isUseCompression, isUseDedicatedTaskRunner, isUseRetroactiveConsumer, isUserSpecifiedClientID, isWatchTopicAdvisories, makeConnection, makeConnection, makeConnection, onAsyncException, onClientInternalException, onCommand, onConnectionControl, onConsumerControl, onException, onWireFormatInfo, removeConnectionConsumer, removeDispatcher, removeDispatcher, removeProducer, removeSession, removeTransportListener, rollbackDuplicate, setAlwaysSessionAsync, setAlwaysSyncSend, setAuditDepth, setAuditMaximumProducerNumber, setBlobTransferPolicy, setCheckForDuplicates, setClientID, setClientInternalExceptionListener, setCloseTimeout, setConnectResponseTimeout, setConsumerExpiryCheckEnabled, setConsumerFailoverRedeliveryWaitPeriod, setCopyMessageOnSend, setDefaultClientID, setDisableTimeStampsByDefault, setDispatchAsync, setExceptionListener, setExclusiveConsumer, setMaxThreadPoolSize, setMessagePrioritySupported, setNestedMapAndListEnabled, setNonBlockingRedelivery, setObjectMessageSerializationDefered, setOptimizeAcknowledge, setOptimizeAcknowledgeTimeOut, setOptimizedAckScheduledAckInterval, setOptimizedMessageDispatch, setPassword, setPrefetchPolicy, setProducerWindowSize, setRedeliveryPolicy, setRedeliveryPolicyMap, setRejectedTaskHandler, setRmIdFromConnectionId, setSendAcksAsync, setSendTimeout, setSessionTaskRunner, setStatsEnabled, setTransactedIndividualAck, setTransformer, setTrustAllPackages, setTrustedPackages, setUseAsyncSend, setUseCompression, setUseDedicatedTaskRunner, setUseRetroactiveConsumer, setUserName, setWarnAboutUnstartedConnectionTimeout, setWatchTopicAdvisories, start, stop, syncSendPacket, syncSendPacket, syncSendPacket, toString, transportFailed, transportInterruptionProcessingComplete, transportInterupted, transportResumed, unsubscribe, waitForTransportInterruptionProcessingToComplete

Methods inherited from class java.lang.Object

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

Methods inherited from interface jakarta.jms.Connection

close, createConnectionConsumer, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface jakarta.jms.QueueConnection

createConnectionConsumer

Methods inherited from interface jakarta.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

Methods inherited from interface jakarta.jms.XAQueueConnection

createQueueSession

Methods inherited from interface jakarta.jms.XATopicConnection

createTopicSession

Constructor Details

ActiveMQXAConnection

protected ActiveMQXAConnection(Transport transport,
 IdGenerator clientIdGenerator,
 IdGenerator connectionIdGenerator,
 JMSStatsImpl factoryStats)
                        throws Exception

Throws:

Exception

Method Details

createXASession

public jakarta.jms.XASession createXASession()
                                      throws jakarta.jms.JMSException

Specified by:

createXASession in interface jakarta.jms.XAConnection

Throws:

jakarta.jms.JMSException

createXATopicSession

public jakarta.jms.XATopicSession createXATopicSession()
                                                throws jakarta.jms.JMSException

Specified by:

createXATopicSession in interface jakarta.jms.XATopicConnection

Throws:

jakarta.jms.JMSException

createXAQueueSession

public jakarta.jms.XAQueueSession createXAQueueSession()
                                                throws jakarta.jms.JMSException

Specified by:

createXAQueueSession in interface jakarta.jms.XAQueueConnection

Throws:

jakarta.jms.JMSException

createSession

public jakarta.jms.Session createSession(boolean transacted,
 int acknowledgeMode)
                                  throws jakarta.jms.JMSException

Description copied from class: ActiveMQConnection

Creates a Session object.

Specified by:

createSession in interface jakarta.jms.Connection

Specified by:

createSession in interface jakarta.jms.XAConnection

Overrides:

createSession in class ActiveMQConnection

Parameters:

transacted - indicates whether the session is transacted

acknowledgeMode - indicates whether the consumer or the client will acknowledge any messages it receives; ignored if the session is transacted. Legal values are Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, and Session.DUPS_OK_ACKNOWLEDGE.

Returns:

a newly created session

Throws:

jakarta.jms.JMSException - if the Connection object fails to create a session due to some internal error or lack of support for the specific transaction and acknowledgement mode.

See Also:

• Session.AUTO_ACKNOWLEDGE
• Session.CLIENT_ACKNOWLEDGE
• Session.DUPS_OK_ACKNOWLEDGE

setXaAckMode

public void setXaAckMode(int xaAckMode)

getXaAckMode

public int getXaAckMode()