edu.umass.cs.txn

Class Transaction

java.lang.Object

edu.umass.cs.txn.Transaction

All Implemented Interfaces:

TXInterface, TXRequest, java.lang.Iterable<TxOp>

public class Transaction
extends java.lang.Object
implements TXInterface

Author:

arun A transaction is an indivisible sequence of operations that satisfy ACID (atomicity, consistency, isolation, and durability) properties.

The list of individual TxOp operations must either be a ClientRequest or ClientReconfigurationPacket. If any of the TxOp operations is a DeleteServiceName request, the deletion(s) need to be implemented as an in-memory pre-delete operation at both reconfigurators and active replicas so that they can be reverted if necessary.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Transaction.Keys

Constructor Summary

Constructors

Constructor and Description
Transaction(java.net.InetSocketAddress entryServer, TXInterface tx)
Transaction(java.net.InetSocketAddress entryServer, TXRequest tx)

Method Summary

Modifier and Type	Method and Description
protected java.net.InetSocketAddress	getEntryServer()
java.util.TreeSet<java.lang.String>	getLockList()
java.lang.String	getTxGroupName() The transaction group name must be globally unique, otherwise the transaction will fail in the very first tx_group creation step.
java.lang.String	getTXID()
protected java.lang.String	getTxInitState()
java.util.ArrayList<TxOp>	getTxOps()
java.util.Iterator<TxOp>	iterator()
protected static java.lang.String	releaseTxid(long txid)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Transaction

public Transaction(java.net.InetSocketAddress entryServer,
                   TXInterface tx)

Parameters:

entryServer -

tx -

Transaction

public Transaction(java.net.InetSocketAddress entryServer,
                   TXRequest tx)

Parameters:

entryServer -

tx -

Method Detail

getLockList

public java.util.TreeSet<java.lang.String> getLockList()

Specified by:

getLockList in interface TXRequest

Returns:

The set of lock identifiers needed for this transaction in lexicographic order. The lock identifiers are in general a subset of participant groups in the transaction as name creation and deletion requests are excluded from this list.

getTxOps

public java.util.ArrayList<TxOp> getTxOps()

Returns:

The sequence of operations constituting this transaction. Modifying this sequence will violate safety.

getTXID

public java.lang.String getTXID()

Specified by:

getTXID in interface TXInterface

Returns:

An ID for this transaction created by concatenating the issuer's address and the long transaction number; for safety, this ID must be unique across all transactions in the system, so the same issuer must not issue different transactions with the same transaction number.

getTxGroupName

public java.lang.String getTxGroupName()

The transaction group name must be globally unique, otherwise the transaction will fail in the very first tx_group creation step.

Returns:

The name of this transaction, which also acts as the name of the replica group conducting the transaction. The name is composed of the sender ID and a long transaction number that is chosen uniquely at each sender.

getTxInitState

protected java.lang.String getTxInitState()

getEntryServer

protected java.net.InetSocketAddress getEntryServer()

releaseTxid

protected static java.lang.String releaseTxid(long txid)

iterator

public java.util.Iterator<TxOp> iterator()

Specified by:

iterator in interface java.lang.Iterable<TxOp>