hydra.blackboard

Interface SharedLock

All Known Implementing Classes:

AnySharedLockImpl

public interface SharedLock

A nonreentrant lock useful for synchronizing across hydra client VMs. For example, it can be used to atomically read and update the shared map or to serialize arbitrary sections of test code. Can be used from both logical hydra threads (across task boundaries) and from non-hydra threads such as product-spawned listener threads.

Method Summary

Modifier and Type	Method and Description
SharedCondition	getCondition(String name) Get a condition object associated with this lock, which can be used to signal from one VM to another.
void	lock() Locks the lock on behalf of this thread, waiting forever.
void	unlock() Unlocks the lock on behalf of this thread.

Method Detail

lock

void lock()

Locks the lock on behalf of this thread, waiting forever. Use with care to avoid deadlock and excessive overhead. The time spent holding a lock should be minimal to avoid long-lived RMI calls.

Throws:

HydraRuntimeException - if the lock is already locked by this logical thread.

unlock

void unlock()

Unlocks the lock on behalf of this thread.

Throws:

HydraRuntimeException - if the lock is already unlocked or is owned by another logical thread.

getCondition

SharedCondition getCondition(String name)

Get a condition object associated with this lock, which can be used to signal from one VM to another. The time spent waiting on a condition should be minimal to avoid long-lived RMI calls.