bitronix.tm.resource.common

Class TransactionContextHelper

java.lang.Object

bitronix.tm.resource.common.TransactionContextHelper

public class TransactionContextHelper
extends java.lang.Object

Helper class that contains static logic common accross all resource types.

Author:

lorban

Constructor Summary

Constructors

Constructor and Description
TransactionContextHelper()

Method Summary

Modifier and Type	Method and Description
static BitronixTransaction	currentTransaction() Get the transaction running on the current thead context.
static void	delistFromCurrentTransaction(XAResourceHolder xaResourceHolder) Delist the XAResourceHolder from the current transaction or do nothing if there is no global transaction context for this thread.
static void	enlistInCurrentTransaction(XAResourceHolder xaResourceHolder) Enlist the XAResourceHolder in the current transaction or do nothing if there is no global transaction context for this thread.
static void	recycle(XAStatefulHolder xaStatefulHolder) Ensure the XAStatefulHolder's release won't be deferred anymore (when appropriate) as it has been recycled.
static void	requeue(XAStatefulHolder xaStatefulHolder, ResourceBean bean) Switch the XAStatefulHolder's state appropriately after the acquired resource handle has been closed.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionContextHelper

public TransactionContextHelper()

Method Detail

enlistInCurrentTransaction

public static void enlistInCurrentTransaction(XAResourceHolder xaResourceHolder)
                                       throws javax.transaction.SystemException,
                                              javax.transaction.RollbackException

Enlist the XAResourceHolder in the current transaction or do nothing if there is no global transaction context for this thread.

Parameters:

xaResourceHolder - the XAResourceHolder to enlist.

Throws:

javax.transaction.SystemException - if an internal error happens.

javax.transaction.RollbackException - if the current transaction has been marked as rollback only.

delistFromCurrentTransaction

public static void delistFromCurrentTransaction(XAResourceHolder xaResourceHolder)
                                         throws javax.transaction.SystemException

Delist the XAResourceHolder from the current transaction or do nothing if there is no global transaction context for this thread.

Parameters:

xaResourceHolder - the XAResourceHolder to delist.

Throws:

javax.transaction.SystemException - if an internal error happens.

currentTransaction

public static BitronixTransaction currentTransaction()

Get the transaction running on the current thead context.

Returns:

null if there is no transaction on the current context or if the transaction manager is not running.

requeue

public static void requeue(XAStatefulHolder xaStatefulHolder,
                           ResourceBean bean)
                    throws BitronixSystemException

Switch the XAStatefulHolder's state appropriately after the acquired resource handle has been closed. The pooled resource will either be marked as closed or not accessible, depending on the value of the bean's deferConnectionRelease property and will be marked for release after 2PC execution in the latter case.

Parameters:

xaStatefulHolder - the XAStatefulHolder to requeue.

bean - the ResourceBean of the XAResourceHolder.

Throws:

BitronixSystemException - if an internal error happens.

recycle

public static void recycle(XAStatefulHolder xaStatefulHolder)

Ensure the XAStatefulHolder's release won't be deferred anymore (when appropriate) as it has been recycled.

Parameters:

xaStatefulHolder - the recycled XAStatefulHolder.