cern.entwined

Class GlobalReference<T>

java.lang.Object

cern.entwined.GlobalReference<T>

Type Parameters:

T - The reference value type.

public class GlobalReference<T>
extends Object

This class enables aggregation of transactional references within non transactional entities. Global reference must be treated as transactional and thread local.

Author:

Ivan Koblik

Constructor Summary

Constructors

Constructor and Description
GlobalReference(Memory<?> memory, T object) Creates an instance of GlobalReference using given memory and object.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	finalize() Runs a small transaction that removes the referenced object from the global map.
T	get() Retrieves the globally referenced object.
T	set(T newValue) Sets the globally referenced object.

Methods inherited from class java.lang.Object

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

Constructor Detail

GlobalReference

public GlobalReference(Memory<?> memory,
               T object)

Creates an instance of GlobalReference using given memory and object.

Parameters:

memory - The instance of Memory class.

object - The globally referenced object of type T.

Method Detail

get

public T get()

Retrieves the globally referenced object.

Returns:

The globally referenced object.

set

public T set(T newValue)

Sets the globally referenced object.

Parameters:

newValue - The new value.

Returns:

The replaced value.

finalize

protected void finalize()
                 throws Throwable

Runs a small transaction that removes the referenced object from the global map.

May lead to memory leaks if transaction fails too many times. But, in theory, this transaction should never fail as it removes an element that no one else would ever access.

Overrides:

finalize in class Object

Throws:

Throwable

See Also:

Object.finalize()