org.apache.geronimo.transaction.manager
Interface TransactionLog

All Known Implementing Classes:

HOWLLog, UnrecoverableLog

public interface TransactionLog

Interface used to notify a logging subsystem of transaction events.

Version:

$Rev: 912058 $ $Date: 2010-02-20 09:34:14 +0800 (Sat, 20 Feb 2010) $

Method Summary

void	begin(javax.transaction.xa.Xid xid)
void	commit(javax.transaction.xa.Xid xid, java.lang.Object logMark)
int	getAverageBytesPerForce()
int	getAverageForceTime()
java.lang.String	getXMLStats()
java.lang.Object	prepare(javax.transaction.xa.Xid xid, java.util.List<? extends TransactionBranchInfo> branches) log prepare for the global xid xid and the list of TransactionBranchInfo branches
java.util.Collection<Recovery.XidBranchesPair>	recover(XidFactory xidFactory) Recovers the log, returning a map of (top level) xid to List of TransactionBranchInfo for the branches.
void	rollback(javax.transaction.xa.Xid xid, java.lang.Object logMark)

Method Detail

begin

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

Throws:

LogException

prepare

java.lang.Object prepare(javax.transaction.xa.Xid xid,
                         java.util.List<? extends TransactionBranchInfo> branches)
                         throws LogException

log prepare for the global xid xid and the list of TransactionBranchInfo branches

Parameters:

xid - global xid for the transactions

branches - List of TransactionBranchInfo

Returns:

log mark to use in commit/rollback calls.

Throws:

LogException - on error

commit

void commit(javax.transaction.xa.Xid xid,
            java.lang.Object logMark)
            throws LogException

Throws:

LogException

rollback

void rollback(javax.transaction.xa.Xid xid,
              java.lang.Object logMark)
              throws LogException

Throws:

LogException

recover

java.util.Collection<Recovery.XidBranchesPair> recover(XidFactory xidFactory)
                                                       throws LogException

Recovers the log, returning a map of (top level) xid to List of TransactionBranchInfo for the branches. Uses the XidFactory to reconstruct the xids.

Parameters:

xidFactory - Xid factory

Returns:

Map of recovered xid to List of TransactionBranchInfo representing the branches.

Throws:

LogException - on error

getXMLStats

java.lang.String getXMLStats()

getAverageForceTime

int getAverageForceTime()

getAverageBytesPerForce

int getAverageBytesPerForce()