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(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()