cern.entwined

Class Memory<T extends SemiPersistent<T>>

java.lang.Object

cern.entwined.Memory<T>

Type Parameters:

T - The client SemiPersistent type.

public class Memory<T extends SemiPersistent<T>>
extends Object

Software transactional memory root class. It manages global memory snapshot and concurrent execution of transactions.

Author:

Ivan Koblik

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	NUM_RETRIES Number of retries of a transaction in case of conflicts.

Constructor Summary

Constructors

Constructor and Description
Memory(T initialState) Creates transactional memory with given initial state.

Method Summary

Methods

Modifier and Type	Method and Description
protected cern.entwined.BaseSnapshot<T>	getBaseSnapshot() Checks if there is a running transaction and if there is returns its snapshot.
protected Long	getNextId() Returns the next unique ID that can be used in BaseSnapshot.
boolean	runTransaction(Transaction<T> transaction) Executes a transaction and calls the given transactional user code.

Methods inherited from class java.lang.Object

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

Field Detail

NUM_RETRIES

protected static final int NUM_RETRIES

Number of retries of a transaction in case of conflicts.

See Also:

Constant Field Values

Constructor Detail

Memory

public Memory(T initialState)

Creates transactional memory with given initial state.

Parameters:

initialState - The initial state of transactional memory. It takes a clean copy of it.

Method Detail

runTransaction

public boolean runTransaction(Transaction<T> transaction)

Executes a transaction and calls the given transactional user code.

Parameters:

transaction - The transaction interface implementation.

Returns:

the commit state true if committed, false if rolled back.

getBaseSnapshot

protected cern.entwined.BaseSnapshot<T> getBaseSnapshot()

Checks if there is a running transaction and if there is returns its snapshot.

Returns:

The currently running transaction's snapshot.

Throws:

MemoryException - if there is no running transaction.

getNextId

protected Long getNextId()

Returns the next unique ID that can be used in BaseSnapshot.

Returns:

Unique ID for this memory instance.