ch.maxant.generic_jca_adapter

Interface TransactionAssistanceFactory

All Superinterfaces:

BasicTransactionAssistanceFactory, Referenceable, Serializable

public interface TransactionAssistanceFactory
extends Serializable, javax.resource.Referenceable, BasicTransactionAssistanceFactory

The resource injected into say a Servlet or EJB. Used to bind a resource into the active XA transaction.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TransactionAssistanceFactory.CommitRollbackRecoveryCallback Classes with this interface are registered with the TransactionAssistanceFactory.

Method Summary

Modifier and Type	Method and Description
void	registerCommitRollbackRecovery(TransactionAssistanceFactory.CommitRollbackRecoveryCallback commitRollbackRecoveryCallback) The application must register a callback which can be used to commit or rollback transactions as well as recover unfinished transactions.
void	unregisterCommitRollbackRecovery() unregister the callback previously registered.

Methods inherited from interface javax.resource.Referenceable

setReference

Methods inherited from interface javax.naming.Referenceable

getReference

Methods inherited from interface ch.maxant.generic_jca_adapter.BasicTransactionAssistanceFactory

getTransactionAssistant

Method Detail

registerCommitRollbackRecovery

void registerCommitRollbackRecovery(TransactionAssistanceFactory.CommitRollbackRecoveryCallback commitRollbackRecoveryCallback)

The application must register a callback which can be used to commit or rollback transactions as well as recover unfinished transactions. Normally this is called once during application startup. That way, the callback is available as soon as recovery might need it, e.g. in the scenario where the server is starting after a crash.

unregisterCommitRollbackRecovery

void unregisterCommitRollbackRecovery()

unregister the callback previously registered. Note the resource adapter can only ever contain one callback per connection factory, and will fail hard if you don't unregister before re-registering a callback. Normally this is only called when an application is shutdown.