Package 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.

Method Summary

Modifier and Type	Method	Description
void	begin(Xid xid)
void	commit(Xid xid, Object logMark)
int	getAverageBytesPerForce()
int	getAverageForceTime()
String	getXMLStats()
Object	prepare(Xid xid, List<? extends TransactionBranchInfo> branches)	log prepare for the global xid xid and the list of TransactionBranchInfo branches
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(Xid xid, Object logMark)

Method Detail

begin

void begin(Xid xid)
    throws LogException

Throws:

LogException

prepare

Object prepare(Xid xid,
               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(Xid xid,
            Object logMark)
     throws LogException

Throws:

LogException

rollback

void rollback(Xid xid,
              Object logMark)
       throws LogException

Throws:

LogException

recover

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

String getXMLStats()

getAverageForceTime

int getAverageForceTime()

getAverageBytesPerForce

int getAverageBytesPerForce()