org.wildfly.transaction.client

Interface XAImporter

All Superinterfaces:

XARecoverable

public interface XAImporter
extends XARecoverable

The API which must be implemented by transaction providers that support transaction inflow.

Author:

David M. Lloyd

Method Summary

Modifier and Type	Method and Description
void	beforeComplete(Xid xid) Perform before-completion processing.
void	commit(Xid xid, boolean onePhase) Commit an imported (typically prepared) transaction.
Transaction	findExistingTransaction(Xid xid) Find an existing transaction on this system.
ImportResult<?>	findOrImportTransaction(Xid xid, int timeout) Import a transaction.
void	forget(Xid xid) Forget an imported, prepared transaction.
Xid[]	recover(int flag, String parentName) Initiate a recovery scan.

Methods inherited from interface org.wildfly.transaction.client.XARecoverable

from, from, recover

Method Detail

findOrImportTransaction

@NotNull
ImportResult<?> findOrImportTransaction(Xid xid,
                                                 int timeout)
                                          throws XAException

Import a transaction. If the transaction already exists, it should be returned, otherwise a new transaction should be initiated with the given timeout (in seconds).

Parameters:

xid - the transaction ID (must not be null)

timeout - the remaining transaction timeout, or 0 if the default should be used

Returns:

the imported transaction (must not be null)

Throws:

XAException - if the import failed for some reason

findExistingTransaction

Transaction findExistingTransaction(Xid xid)
                             throws XAException

Find an existing transaction on this system. If no such transaction exists, null is returned. Normally the transaction is located only by global ID.

Parameters:

xid - the XID to search for (must not be null)

Returns:

the transaction object, or null if the transaction is not known

Throws:

XAException - if the transaction manager failed for some reason

beforeComplete

void beforeComplete(Xid xid)
             throws XAException

Perform before-completion processing.

Parameters:

xid - the transaction ID (must not be null)

Throws:

XAException - if the import failed for some reason

commit

void commit(Xid xid,
            boolean onePhase)
     throws XAException

Commit an imported (typically prepared) transaction.

Specified by:

commit in interface XARecoverable

Parameters:

xid - the transaction ID (must not be null)

onePhase - true to perform prepare and commit in one operation, false otherwise

Throws:

XAException - if the operation fails for some reason

forget

void forget(Xid xid)
     throws XAException

Forget an imported, prepared transaction.

Specified by:

forget in interface XARecoverable

Parameters:

xid - the transaction ID (must not be null)

Throws:

XAException - if the operation fails for some reason

recover

@NotNull
Xid[] recover(int flag,
                       String parentName)
                throws XAException

Initiate a recovery scan.

Specified by:

recover in interface XARecoverable

Parameters:

flag - one of XAResource.TMSTARTRSCAN, XAResource.TMNOFLAGS, or XAResource.TMENDRSCAN

parentName - the name of the node to recover on behalf of, or null for all

Returns:

the array of recovered XIDs (may be SimpleXid.NO_XIDS, must not be null)

Throws:

XAException - if the operation fails for some reason