cz.cuni.amis.utils.flag

Class WaitForFlagChange<TYPE>

java.lang.Object

cz.cuni.amis.utils.flag.WaitForFlagChange<TYPE>

Type Parameters:

TYPE -

public class WaitForFlagChange<TYPE>
extends Object

This class is implementing the waiting on some flag value.

Note that you may call only one AWAIT() at time.

Typical usage:
boolean flagValue = new WaitForFlagChange<Boolean>(booleanFlag, Boolean.TRUE).await();
int flagValue = new WaitForFlagChange<Integer>(integerFlag, new Integer[]{1,3}).await();

Author:

Jimmy

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	WaitForFlagChange.IAccept<TYPE>

Constructor Summary

Constructors

Constructor and Description
WaitForFlagChange(IFlag<TYPE> flag) Wait for the next flag change.
WaitForFlagChange(IFlag<TYPE> flag, Collection<TYPE> waitingFor)
WaitForFlagChange(IFlag<TYPE> flag, TYPE waitingFor)
WaitForFlagChange(IFlag<TYPE> flag, TYPE[] waitingFor)
WaitForFlagChange(IFlag<TYPE> flag, WaitForFlagChange.IAccept<TYPE> waitingFor)

Method Summary

Methods

Modifier and Type	Method and Description
TYPE	await() Note that you may call only await() from one thread! If the instance is already in used it may produce unwanted behavior (e.g.
TYPE	await(long timeout, TimeUnit timeUnit) Note that you may call only await() from one thread! If the instance is already in used it may produce unwanted behavior.

Methods inherited from class java.lang.Object

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

Constructor Detail

WaitForFlagChange

public WaitForFlagChange(IFlag<TYPE> flag)

Wait for the next flag change.

Parameters:

flag -

WaitForFlagChange

public WaitForFlagChange(IFlag<TYPE> flag,
                 WaitForFlagChange.IAccept<TYPE> waitingFor)

WaitForFlagChange

public WaitForFlagChange(IFlag<TYPE> flag,
                 TYPE waitingFor)

WaitForFlagChange

public WaitForFlagChange(IFlag<TYPE> flag,
                 TYPE[] waitingFor)

WaitForFlagChange

public WaitForFlagChange(IFlag<TYPE> flag,
                 Collection<TYPE> waitingFor)

Method Detail

await

public TYPE await()
           throws PogamutInterruptedException

Note that you may call only await() from one thread! If the instance is already in used it may produce unwanted behavior (e.g. dead-lock).

Returns:

value from the flag that raised the latch

Throws:

InterruptedException

PogamutInterruptedException

await

public TYPE await(long timeout,
         TimeUnit timeUnit)
           throws PogamutInterruptedException

Note that you may call only await() from one thread! If the instance is already in used it may produce unwanted behavior.

Returns null if desired value hasn't been set at the flag before timeout.

Parameters:

timeout -

timeUnit -

Returns:

value of the flag

Throws:

PogamutInterruptedException