edu.rice.hj.runtime.baseruntime

Class IsolationManager

java.lang.Object

edu.rice.hj.runtime.baseruntime.IsolationManager

public class IsolationManager
extends Object

IsolationManager class.

Author:

Shams Imam (shams@rice.edu)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IsolationManager.EventType
static class	IsolationManager.OrderedReadWriteLockList

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IsolationManager(int confNumLocks) Constructor.

Method Summary

Modifier and Type	Method and Description
void	attachListener(PropertyChangeListener changeListener) attachListener.
static IsolationManager	factory(int confNumLocks) Factory method.
Lock[]	globalLocks() Retrieve the 'global' locks
boolean	isInsideIsolatedBlock() isInsideIsolatedBlock.
void	lock(Lock[] locksToUse) This methods also handles the case where nested lock requests are made.
Object	readMode(Object wrappee) readMode.
Lock	retrievePseudoLock(Object candidateObject)
Lock[]	retrievePseudoLocksSorted(Object[] candidateObjects)
void	unlock(Lock[] locksToUse)
Object	writeMode(Object wrappee) writeMode.

Methods inherited from class java.lang.Object

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

Constructor Detail

IsolationManager

protected IsolationManager(int confNumLocks)

Constructor.

Parameters:

confNumLocks - The granularity control for the number of representative locks to use.

Method Detail

factory

public static IsolationManager factory(int confNumLocks)

Factory method.

Parameters:

confNumLocks - The granularity control for the number of representative locks to use.

Returns:

a new instance of the IsolationManager using the specified granularity control.

attachListener

public final void attachListener(PropertyChangeListener changeListener)

attachListener.

Parameters:

changeListener - The listener to attach to the future. The listener may be synchronously triggered.

isInsideIsolatedBlock

public final boolean isInsideIsolatedBlock()

isInsideIsolatedBlock.

Returns:

true if the currently executing activity is inside an isolated block.

globalLocks

public final Lock[] globalLocks()

Retrieve the 'global' locks

lock

public final void lock(Lock[] locksToUse)

This methods also handles the case where nested lock requests are made. In such a scenario, a nested lock request will fail if the locks are not already attained!

Parameters:

locksToUse - The candidate locks to use

unlock

public final void unlock(Lock[] locksToUse)

Parameters:

locksToUse - The candidate locks to use

retrievePseudoLock

public Lock retrievePseudoLock(Object candidateObject)

Parameters:

candidateObject - The candidate object

Returns:

The ordered representative lock object

retrievePseudoLocksSorted

public Lock[] retrievePseudoLocksSorted(Object[] candidateObjects)

Parameters:

candidateObjects - The set of candidate objects

Returns:

The canonical set of ordered representative lock objects

readMode

public Object readMode(Object wrappee)

readMode.

Parameters:

wrappee - a Object object.

Returns:

a Object object.

writeMode

public Object writeMode(Object wrappee)

writeMode.

Parameters:

wrappee - a Object object.

Returns:

a Object object.