ch.maxant.generic_jca_adapter

Class ManagedTransactionAssistance

java.lang.Object

ch.maxant.generic_jca_adapter.ManagedTransactionAssistance

All Implemented Interfaces:

Serializable, javax.resource.spi.ManagedConnection

public class ManagedTransactionAssistance
extends Object
implements javax.resource.spi.ManagedConnection, Serializable

There is an assumption here that instances of this class are not thread safe in that they can only be used one at a time. EXECUTE-COMMIT or EXECUTE-ROLLBACK. The class contains logic to ensure this.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ManagedTransactionAssistance(TransactionAssistanceFactory.CommitRollbackRecoveryCallback commitRollbackRecoveryCallback, boolean handleRecoveryInternally, File recoveryStatePersistenceDirectory, String managedConnectionFactoryId)

Method Summary

Modifier and Type	Method and Description
void	addConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)
void	associateConnection(Object connection)
void	cleanup()
void	close(TransactionAssistant handle)
void	destroy()
<O> O	execute(ExecuteCallback<O> f) Calls the callback to do some work bound into the transaction.
TransactionAssistanceFactory.CommitRollbackRecoveryCallback	getCommitRollbackRecoveryCallback()
Object	getConnection(Subject subject, javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
javax.resource.spi.LocalTransaction	getLocalTransaction()
PrintWriter	getLogWriter()
String	getManagedConnectionFactoryId() the managedConnectionFactoryId of the managed connection factory
javax.resource.spi.ManagedConnectionMetaData	getMetaData()
File	getRecoveryStatePersistenceDirectory()
XAResource	getXAResource()
boolean	isHandleRecoveryInternally()
void	removeConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)
void	setCurrentTxId(String txId)
void	setLogWriter(PrintWriter logWriter)
boolean	wasExecuteSuccessful() Was the call to the execute method successful? Used by the XAResource to determine if PREPARE can return OK or NOK.

Methods inherited from class java.lang.Object

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

Constructor Detail

ManagedTransactionAssistance

public ManagedTransactionAssistance(TransactionAssistanceFactory.CommitRollbackRecoveryCallback commitRollbackRecoveryCallback,
                                    boolean handleRecoveryInternally,
                                    File recoveryStatePersistenceDirectory,
                                    String managedConnectionFactoryId)

Method Detail

getLogWriter

public PrintWriter getLogWriter()
                         throws javax.resource.ResourceException

Specified by:

getLogWriter in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

setLogWriter

public void setLogWriter(PrintWriter logWriter)
                  throws javax.resource.ResourceException

Specified by:

setLogWriter in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

getConnection

public Object getConnection(Subject subject,
                            javax.resource.spi.ConnectionRequestInfo cxRequestInfo)
                     throws javax.resource.ResourceException

Specified by:

getConnection in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

associateConnection

public void associateConnection(Object connection)
                         throws javax.resource.ResourceException

Specified by:

associateConnection in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

cleanup

public void cleanup()
             throws javax.resource.ResourceException

Specified by:

cleanup in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

destroy

public void destroy()
             throws javax.resource.ResourceException

Specified by:

destroy in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

addConnectionEventListener

public void addConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)

Specified by:

addConnectionEventListener in interface javax.resource.spi.ManagedConnection

removeConnectionEventListener

public void removeConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)

Specified by:

removeConnectionEventListener in interface javax.resource.spi.ManagedConnection

getLocalTransaction

public javax.resource.spi.LocalTransaction getLocalTransaction()
                                                        throws javax.resource.ResourceException

Specified by:

getLocalTransaction in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

getXAResource

public XAResource getXAResource()
                         throws javax.resource.ResourceException

Specified by:

getXAResource in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

getMetaData

public javax.resource.spi.ManagedConnectionMetaData getMetaData()
                                                         throws javax.resource.ResourceException

Specified by:

getMetaData in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException

execute

public <O> O execute(ExecuteCallback<O> f)
              throws Exception

Calls the callback to do some work bound into the transaction. Tracks transaction state internally if necessary.

Throws:

Exception

close

public void close(TransactionAssistant handle)

wasExecuteSuccessful

public boolean wasExecuteSuccessful()

Was the call to the execute method successful? Used by the XAResource to determine if PREPARE can return OK or NOK.

Throws:

IllegalStateException - if the call to execute has not yet occurred

setCurrentTxId

public void setCurrentTxId(String txId)

getCommitRollbackRecoveryCallback

public TransactionAssistanceFactory.CommitRollbackRecoveryCallback getCommitRollbackRecoveryCallback()

isHandleRecoveryInternally

public boolean isHandleRecoveryInternally()

getRecoveryStatePersistenceDirectory

public File getRecoveryStatePersistenceDirectory()

getManagedConnectionFactoryId

public String getManagedConnectionFactoryId()

the managedConnectionFactoryId of the managed connection factory