Package bitronix.tm.resource.messaging

Class MessagingPooledConnection

java.lang.Object

bitronix.tm.resource.common.AbstractXAStatefulHolder

bitronix.tm.resource.messaging.MessagingPooledConnection

All Implemented Interfaces:

XAStatefulHolder, MessagingPooledConnectionMBean

public class MessagingPooledConnection
extends AbstractXAStatefulHolder
implements MessagingPooledConnectionMBean

Implementation of a JMS pooled connection wrapping vendor's XAConnection implementation.

Author:

lorban TODO: how can the JMS connection be accurately tested?

Field Summary

Fields inherited from interface bitronix.tm.resource.common.XAStatefulHolder

STATE_ACCESSIBLE, STATE_CLOSED, STATE_IN_POOL, STATE_NOT_ACCESSIBLE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MessagingPooledConnection(PoolingConnectionFactory poolingConnectionFactory, jakarta.jms.XAConnection connection)

Method Summary

Modifier and Type	Method	Description
void	close()	Close the physical connection that this XAStatefulHolder represents.
RecoveryXAResourceHolder	createRecoveryXAResourceHolder()
protected jakarta.jms.Session	createSession(boolean transacted, int acknowledgeMode)
Date	getAcquisitionDate()
Object	getConnectionHandle()	Create a disposable handler used to drive a pooled instance of XAStatefulHolder.
Date	getLastReleaseDate()	Get the date at which this object was last released to the pool.
PoolingConnectionFactory	getPoolingConnectionFactory()
String	getStateDescription()
Collection<String>	getTransactionGtridsCurrentlyHoldingThis()
jakarta.jms.XAConnection	getXAConnection()
List<XAResourceHolder>	getXAResourceHolders()	Get the list of XAResourceHolders created by this XAStatefulHolder that are still open.
protected void	release()
String	toString()

Methods inherited from class bitronix.tm.resource.common.AbstractXAStatefulHolder

addStateChangeEventListener, getState, removeStateChangeEventListener, setState

Methods inherited from class java.lang.Object

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

Constructor Details

MessagingPooledConnection

protected MessagingPooledConnection(PoolingConnectionFactory poolingConnectionFactory,
 jakarta.jms.XAConnection connection)

Method Details

getXAConnection

public jakarta.jms.XAConnection getXAConnection()

getPoolingConnectionFactory

public PoolingConnectionFactory getPoolingConnectionFactory()

createRecoveryXAResourceHolder

public RecoveryXAResourceHolder createRecoveryXAResourceHolder()
                                                        throws jakarta.jms.JMSException

Throws:

jakarta.jms.JMSException

close

public void close()
           throws jakarta.jms.JMSException

Description copied from interface: XAStatefulHolder

Close the physical connection that this XAStatefulHolder represents.

Specified by:

close in interface XAStatefulHolder

Throws:

jakarta.jms.JMSException

getXAResourceHolders

public List<XAResourceHolder> getXAResourceHolders()

Description copied from interface: XAStatefulHolder

Get the list of XAResourceHolders created by this XAStatefulHolder that are still open.

This method is thread-safe.

Specified by:

getXAResourceHolders in interface XAStatefulHolder

Returns:

the list of XAResourceHolders created by this XAStatefulHolder that are still open.

getConnectionHandle

public Object getConnectionHandle()
                           throws Exception

Description copied from interface: XAStatefulHolder

Create a disposable handler used to drive a pooled instance of XAStatefulHolder.

This method is thread-safe.

Specified by:

getConnectionHandle in interface XAStatefulHolder

Returns:

a resource-specific disaposable connection object.

Throws:

Exception - a resource-specific exception thrown when the disaposable connection cannot be created.

release

protected void release()
                throws jakarta.jms.JMSException

Throws:

jakarta.jms.JMSException

createSession

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

Throws:

jakarta.jms.JMSException

getLastReleaseDate

public Date getLastReleaseDate()

Description copied from interface: XAStatefulHolder

Get the date at which this object was last released to the pool. This is required to check if it is eligible for discard when the containing pool needs to shrink.

Specified by:

getLastReleaseDate in interface XAStatefulHolder

Returns:

the date at which this object was last released to the pool or null if it never left the pool.

toString

public String toString()

Overrides:

toString in class Object

getStateDescription

public String getStateDescription()

Specified by:

getStateDescription in interface MessagingPooledConnectionMBean

getAcquisitionDate

public Date getAcquisitionDate()

Specified by:

getAcquisitionDate in interface MessagingPooledConnectionMBean

getTransactionGtridsCurrentlyHoldingThis

public Collection<String> getTransactionGtridsCurrentlyHoldingThis()

Specified by:

getTransactionGtridsCurrentlyHoldingThis in interface MessagingPooledConnectionMBean