Class WaitableRef

java.lang.Object

EDU.oswego.cs.dl.util.concurrent.SynchronizedVariable

EDU.oswego.cs.dl.util.concurrent.SynchronizedRef

EDU.oswego.cs.dl.util.concurrent.WaitableRef

All Implemented Interfaces:

Executor

public class WaitableRef
extends SynchronizedRef

A class useful for offloading synch for Object reference instance variables.

[ Introduction to this package. ]

Field Summary

Fields inherited from class SynchronizedRef

value_

Fields inherited from class SynchronizedVariable

lock_

Constructor Summary

Constructors

Constructor	Description
WaitableRef(Object initialValue)	Create a WaitableRef initially holding the given reference and using its own internal lock.
WaitableRef(Object initialValue, Object lock)	Make a new WaitableRef with the given initial value, and using the supplied lock.

Method Summary

Modifier and Type	Method	Description
boolean	commit(Object assumedValue, Object newValue)	Set value to newValue only if it is currently assumedValue.
Object	set(Object newValue)	Set to newValue.
void	whenEqual(Object c, Runnable action)	Wait until value equals c, then run action if nonnull.
void	whenNotEqual(Object c, Runnable action)	wait until value not equal to c, then run action if nonnull.
void	whenNotNull(Runnable action)	wait until value is nonnull, then run action if nonnull.
void	whenNull(Runnable action)	Wait until value is null, then run action if nonnull.

Methods inherited from class SynchronizedRef

get, swap

Methods inherited from class SynchronizedVariable

execute, getLock

Methods inherited from class Object

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

Constructor Details

WaitableRef

public WaitableRef(Object initialValue)

Create a WaitableRef initially holding the given reference and using its own internal lock.

WaitableRef

public WaitableRef(Object initialValue,
 Object lock)

Make a new WaitableRef with the given initial value, and using the supplied lock.

Method Details

set

public Object set(Object newValue)

Description copied from class: SynchronizedRef

Set to newValue.

Overrides:

set in class SynchronizedRef

Returns:

the old value

commit

public boolean commit(Object assumedValue,
 Object newValue)

Description copied from class: SynchronizedRef

Set value to newValue only if it is currently assumedValue.

Overrides:

commit in class SynchronizedRef

Returns:

true if successful

whenNull

public void whenNull(Runnable action)
              throws InterruptedException

Wait until value is null, then run action if nonnull. The action is run with the synchronization lock held.

Throws:

InterruptedException

whenNotNull

public void whenNotNull(Runnable action)
                 throws InterruptedException

wait until value is nonnull, then run action if nonnull. The action is run with the synchronization lock held.

Throws:

InterruptedException

whenEqual

public void whenEqual(Object c,
 Runnable action)
               throws InterruptedException

Wait until value equals c, then run action if nonnull. The action is run with the synchronization lock held.

Throws:

InterruptedException

whenNotEqual

public void whenNotEqual(Object c,
 Runnable action)
                  throws InterruptedException

wait until value not equal to c, then run action if nonnull. The action is run with the synchronization lock held.

Throws:

InterruptedException