ch.maxant.generic_jca_adapter

Interface TransactionAssistanceFactory

All Superinterfaces:

Referenceable, Serializable

public interface TransactionAssistanceFactory
extends Serializable, javax.resource.Referenceable

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
TransactionAssistant	getTransactionAssistant() Get transaction assistant from factory so that a callback can be bound into the transaction as well as recovery which is controlled by the app server's transaction manager.
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

Method Detail

getTransactionAssistant

TransactionAssistant getTransactionAssistant()
                                      throws javax.resource.ResourceException

Get transaction assistant from factory so that a callback can be bound into the transaction as well as recovery which is controlled by the app server's transaction manager.

Throws:

javax.resource.ResourceException - Thrown if an assistant can't be obtained

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.