File Doc Category Size Date Package
LocalTransaction.java API Doc Glassfish v2 API 5303 Fri May 04 22:35:34 BST 2007 javax.resource.cci

LocalTransaction

public interface LocalTransaction

The LocalTransaction defines a transaction demarcation interface for resource manager local transactions. Note that this interface is used for application level local transaction demarcation. The system contract level LocalTransaction interface (as defined in the javax.resource.spi package) is used by the container for local transaction management.

A local transaction is managed internal to a resource manager. There is no external transaction manager involved in the coordination of such transactions.

A CCI implementation can (but is not required to) implement the LocalTransaction interface. If the LocalTransaction interface is supported by a CCI implementation, then the method Connection.getLocalTransaction should return a LocalTransaction instance. A component can then use the returned LocalTransaction to demarcate a resource manager local transaction (associated with the Connection instance) on the underlying EIS instance.

author: Rahul Sharma
since: 0.8
see: javax.resource.cci.Connection

Fields Summary
Constructors Summary
Methods Summary
public void begin()
Begins a local transaction on an EIS instance.
throws
ResourceException Failed to begin a local transaction. Examples of error cases are:

Resource adapter internal or EIS-specific error
Connection is already participating in a local or JTA transaction
public void commit()
Commits the current local transaction and release all locks held by the underlying EIS instance.
throws
ResourceException Failed to commit a local transaction. Examples of error cases are:

Resource adapter internal or EIS-specific error
Violation of integrity constraints, deadlock detection, communication failure during transaction completion, or any retry requirement
Connection is participating in an active JTA transaction
Invalid transaction context; commit operation invoked without an active transaction context
public void rollback()
Rollbacks the current resource manager local transaction.
throws
ResourceException Failed to rollback a local transaction. Examples of error cases are:

Resource adapter internal or EIS-specific error
Connection is participating in an active JTA transaction
Invalid transaction context; rollback operation invoked without an active transaction context