Java 2 Platform EE v1.3: Interface LocalTransaction - Java Platform, Enterprise Edition v1.3.1 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.resource.spi
Interface LocalTransaction

public interface LocalTransaction

LocalTransaction interface provides support for transactions that are managed internal to an EIS resource manager, and do not require an external transaction manager.

A resource adapter implements the javax.resource.spi.LocalTransaction interface to provide support for local transactions that are performed on the underlying resource manager.

If a resource adapter supports the LocalTransaction interface, then the application server can choose to perform local transaction optimization (uses local transaction instead of a JTA transaction for a single resource manager case).

See Also:: ManagedConnection

Method Summary

void begin()
          Begin a local transaction

void commit()
          Commit a local transaction

void rollback()
          Rollback a local transaction

Method Detail

begin

public void begin()
           throws ResourceException

Begin a local transaction

Throws:: ResourceException - generic exception if operation fails; LocalTransactionException - error condition related to local transaction management; ResourceAdapterInternalException - error condition internal to resource adapter; EISSystemException - EIS instance specific error condition

commit

public void commit()
            throws ResourceException

Commit a local transaction

Throws:: ResourceException - generic exception if operation fails; LocalTransactionException - error condition related to local transaction management; ResourceAdapterInternalException - error condition internal to resource adapter; EISSystemException - EIS instance specific error condition

rollback

public void rollback()
              throws ResourceException

Rollback a local transaction

Throws:: ResourceException - generic exception if operation fails; LocalTransactionException - error condition related to local transaction management; ResourceAdapterInternalException - error condition internal to resource adapter; EISSystemException - EIS instance specific error condition