bitronix.tm.resource.common

Class TransactionContextHelper

java.lang.Object

bitronix.tm.resource.common.TransactionContextHelper

public final class TransactionContextHelper
extends Object

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

Author:

Ludovic Orban

Method Summary

Modifier and Type	Method and Description
static BitronixTransaction	currentTransaction() Get the transaction running on the current thead context.
static void	delistFromCurrentTransaction(XAResourceHolder<? extends 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<? extends 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<? extends XAStatefulHolder> xaStatefulHolder) Ensure the XAStatefulHolder's release won't be deferred anymore (when appropriate) as it has been recycled.
static void	requeue(XAStatefulHolder<? extends 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

Method Detail

enlistInCurrentTransaction

public static void enlistInCurrentTransaction(XAResourceHolder<? extends XAResourceHolder> xaResourceHolder)
                                       throws SystemException,
                                              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:

SystemException - if an internal error happens.

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

delistFromCurrentTransaction

public static void delistFromCurrentTransaction(XAResourceHolder<? extends XAResourceHolder> xaResourceHolder)
                                         throws 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:

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<? extends 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<? extends XAStatefulHolder> xaStatefulHolder)

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

Parameters:

xaStatefulHolder - the recycled XAStatefulHolder.