org.jboss.tm

Interface XAResourceRecovery

public interface XAResourceRecovery

During recovery of crashed XA transactions, the transaction system may use instances of this interface to obtain XAResources on which to perform recovery calls. Resource managers should register instances of this interface with the transaction recovery system via an XAResourceRecoveryRegistry.

Version:

$Revision$

See Also:

XAResourceRecoveryRegistry

Method Summary

Modifier and Type	Method and Description
javax.transaction.xa.XAResource[]	getXAResources() Provides XAResource(s) to the transaction system for recovery purposes.

Method Detail

getXAResources

javax.transaction.xa.XAResource[] getXAResources()

Provides XAResource(s) to the transaction system for recovery purposes.

Returns:

An array of XAResource objects for use in transaction recovery In most cases the implementation will need to return only a single XAResource in the array. For more sophisticated cases, such as where multiple different connection types are supported, it may be necessary to return more than one. The Resource should be instantiated in such a way as to carry the necessary permissions to allow transaction recovery. For some deployments it may therefore be necessary or desirable to provide resource(s) based on e.g. database connection parameters such as username other than those used for the regular application connections to the same resource manager.