This interface allows access to commit,prepare,abort global transactions
as part of a two phase commit protocol, during runtime.
These interfaces have been chosen to be exact implementations required to
implement the XAResource interfaces as part of the JTA standard extension.
It is expected that the following interfaces are only used during the
runtime portion of a 2 phase commit connection.
If a runtime exception causes a transaction abort (of a transaction that
has not been successfully prepared), then the transaction will act as if
xa_rollback() had been called. The transaction will be aborted and any
other call other than destroy will throw exceptions.
The XAResource interface is a Java mapping of the industry standard XA resource
manager interface. Please refer to: X/Open CAE Specification - Distributed
Transaction Processing: The XA Specification, X/Open Document No. XO/CAE/91/300
or ISBN 1 872630 24 3.
NOTE - all calls to this interface assume that the caller has insured that
there is no active work being done on the local instance of the transaction
in question. RESOLVE - not sure whether this means that the connection
associated with the transaction must be closed, or if it just means that
synchronization has been provided to provide correct MT behavior from above.
|