bitronix.tm.resource.common

Class RecoveryXAResourceHolder

java.lang.Object

bitronix.tm.resource.common.AbstractXAStatefulHolder<T>

bitronix.tm.resource.common.AbstractXAResourceHolder<RecoveryXAResourceHolder>

bitronix.tm.resource.common.RecoveryXAResourceHolder

All Implemented Interfaces:

XAResourceHolder<RecoveryXAResourceHolder>, XAStatefulHolder<RecoveryXAResourceHolder>

public class RecoveryXAResourceHolder
extends AbstractXAResourceHolder<RecoveryXAResourceHolder>

XAResourceHolder created by an XAResourceProducer that is used to perform recovery. Objects of this class cannot be used outside recovery scope.

Author:

Ludovic Orban

Nested Class Summary

Nested classes/interfaces inherited from interface bitronix.tm.resource.common.XAStatefulHolder

XAStatefulHolder.State

Constructor Summary

Constructors

Constructor and Description
RecoveryXAResourceHolder(XAResourceHolder<? extends XAResourceHolder> xaResourceHolder)

Method Summary

Modifier and Type	Method and Description
void	close() Close the physical connection that this XAStatefulHolder represents.
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.
ResourceBean	getResourceBean() Get the ResourceBean which created this XAResourceHolder.
XAResource	getXAResource() Get the vendor's XAResource implementation of the wrapped resource.
List<RecoveryXAResourceHolder>	getXAResourceHolders() Get the list of XAResourceHolders created by this XAStatefulHolder that are still open.

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

acceptVisitorForXAResourceHolderStates, getXAResourceHolderStateCountForGtrid, getXAResourceHolderStateGtrids, getXAResourceHolderStatesForGtrid, hasStateForXAResource, isExistXAResourceHolderStatesForGtrid, isParticipatingInActiveGlobalTransaction, putXAResourceHolderState, removeXAResourceHolderState

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

addStateChangeEventListener, getCreationDate, getState, removeStateChangeEventListener, setState

Methods inherited from class java.lang.Object

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

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

addStateChangeEventListener, getCreationDate, getState, removeStateChangeEventListener, setState

Constructor Detail

RecoveryXAResourceHolder

public RecoveryXAResourceHolder(XAResourceHolder<? extends XAResourceHolder> xaResourceHolder)

Method Detail

close

public void close()
           throws Exception

Description copied from interface: XAStatefulHolder

Close the physical connection that this XAStatefulHolder represents.

Throws:

Exception - a resource-specific exception thrown when there is an error closing the physical connection.

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.

Returns:

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

getXAResource

public XAResource getXAResource()

Description copied from interface: XAResourceHolder

Get the vendor's XAResource implementation of the wrapped resource.

Returns:

the vendor's XAResource implementation.

getResourceBean

public ResourceBean getResourceBean()

Description copied from interface: XAResourceHolder

Get the ResourceBean which created this XAResourceHolder.

Returns:

the ResourceBean which created this XAResourceHolder.

getXAResourceHolders

public List<RecoveryXAResourceHolder> getXAResourceHolders()

Description copied from interface: XAStatefulHolder

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

This method is thread-safe.

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.

Returns:

a resource-specific disposable connection object.

Throws:

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