oracle.tmm.jta.nonxa

Interface NonXAResource

public interface NonXAResource

The NonXAResource interface is a Java mapping of the Logging Last Resource(LLR) which is not a xa resource and need to participate in the XA transaction

The NonXAResource interface defines the contract between a NonXA Resource Manager and a Transaction Manager in a distributed transaction processing (DTP) environment. NonXA participant needs to implement this interface for participating in the global transaction.

Method Summary

Modifier and Type	Method and Description
void	begin(javax.transaction.xa.Xid xid)
void	commit(javax.transaction.xa.Xid xid, byte[] commitRecord) Informs the Non XA resource manager to commit the local transaction changes
boolean	isSameRM(NonXAResource nxares) This method is called to determine if the Non XA resource manager instance represented by the target object is the same as the Non XA resouce manager instance represented by the parameter nxares.
java.util.List<byte[]>	recover() Obtains a list of commit records persisted by the NonXaResource manager
void	rollback(javax.transaction.xa.Xid xid) Informs the Non XA resource manager to roll back the local transaction

Method Detail

begin

void begin(javax.transaction.xa.Xid xid)
    throws NonXAException

Throws:

NonXAException

commit

void commit(javax.transaction.xa.Xid xid,
            byte[] commitRecord)
     throws NonXAException

Informs the Non XA resource manager to commit the local transaction changes

Parameters:

xid - A global transaction identifier

commitRecord - Transaction commit record to be persisted at the Non XA resource end. It needs to be retuened as part fo recovery call

Throws:

NonXAException - An error has occurred.

rollback

void rollback(javax.transaction.xa.Xid xid)
       throws NonXAException

Informs the Non XA resource manager to roll back the local transaction

Parameters:

xid - A global transaction identifier.

Throws:

NonXAException - An error has occurred.

recover

java.util.List<byte[]> recover()
                        throws NonXAException

Obtains a list of commit records persisted by the NonXaResource manager

Returns:

The resource manager returns zero or more commit records that are persisted after succesful commit of the LLR transactions

Throws:

NonXAException - An error has occurred.

isSameRM

boolean isSameRM(NonXAResource nxares)
          throws NonXAException

This method is called to determine if the Non XA resource manager instance represented by the target object is the same as the Non XA resouce manager instance represented by the parameter nxares.

Parameters:

nxares - An NonXAResource object whose resource manager instance is to be compared with the resource manager instance of the target object.

Returns:

true if it's the same RM instance; otherwise false.

Throws:

NonXAException - An error has occurred.