cern.entwined

Class TransactionalRef<T>

java.lang.Object

cern.entwined.SemiPersistent<TransactionalRef<T>>

cern.entwined.TransactionalRef<T>

Type Parameters:

T - The referenced value type.

All Implemented Interfaces:

Ref<T>

public class TransactionalRef<T>
extends SemiPersistent<TransactionalRef<T>>
implements Ref<T>

Transactional implementation of reference interface.

Author:

Ivan Koblik

Constructor Summary

Constructors

Constructor and Description
TransactionalRef() Constructs the reference object with null as value.
TransactionalRef(T value) Constructs the reference object with the given value.

Method Summary

Methods

Modifier and Type	Method and Description
T	assoc(T newValue) Associates this reference with another value.
TransactionalRef<T>	cleanCopy() Creates a new transactional entity from the current one discarding all the local changes.
TransactionalRef<T>	commit(TransactionalRef<T> globalState)
T	deref() Returns kept value.
protected TransactionalRef<T>	dirtyCopy() Copies references to the source data along with local changes and read/write logs.
protected void	update(TransactionalRef<T> changes, boolean onlyReadLogs) Updates local changes and change logs using change logs of the arguments.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionalRef

public TransactionalRef()

Constructs the reference object with null as value.

TransactionalRef

public TransactionalRef(T value)

Constructs the reference object with the given value.

Parameters:

value - The initial value.

Method Detail

assoc

public T assoc(T newValue)

Description copied from interface: Ref

Associates this reference with another value.

Specified by:

assoc in interface Ref<T>

Parameters:

newValue - The new value.

Returns:

The old referenced value.

deref

public T deref()

Description copied from interface: Ref

Returns kept value.

Specified by:

deref in interface Ref<T>

Returns:

The referenced value.

cleanCopy

public TransactionalRef<T> cleanCopy()

Description copied from class: SemiPersistent

Creates a new transactional entity from the current one discarding all the local changes.

Specified by:

cleanCopy in class SemiPersistent<TransactionalRef<T>>

Returns:

The new entity with no local changes.

dirtyCopy

protected TransactionalRef<T> dirtyCopy()

Description copied from class: SemiPersistent

Copies references to the source data along with local changes and read/write logs.
Note: It is very important to copy source data by reference, otherwise SemiPersistent#update(Object) will not work.

Specified by:

dirtyCopy in class SemiPersistent<TransactionalRef<T>>

Returns:

Dirty copy of this collection, with all the local changes and read/write logs preserved.

update

protected void update(TransactionalRef<T> changes,
          boolean onlyReadLogs)

Description copied from class: SemiPersistent

Updates local changes and change logs using change logs of the arguments. Argument must be constructed from this using SemiPersistent.dirtyCopy().
Note: Any changes done to this collections after branching will be discarded.

Specified by:

update in class SemiPersistent<TransactionalRef<T>>

Parameters:

changes - The branched collection possibly with updates.

onlyReadLogs - If true only read logs are updated. Useful for read-only transactions.

commit

public TransactionalRef<T> commit(TransactionalRef<T> globalState)