Package com.ibm.asyncutil.locks

Class FairAsyncStampedLock

java.lang.Object

com.ibm.asyncutil.locks.FairAsyncReadWriteLock

com.ibm.asyncutil.locks.FairAsyncStampedLock

All Implemented Interfaces:

AsyncReadWriteLock, AsyncStampedLock

public class FairAsyncStampedLock
extends FairAsyncReadWriteLock
implements AsyncStampedLock

An AsyncStampedLock implementation which provides fair ordering of acquisitions, like that of FairAsyncReadWriteLock. The tryOptimisticRead() method also employs fair ordering, in that a stamp will not be issued if there are queued writers waiting to acquire the lock. Validation of an already issued stamp, however, does not abide by this ordering; it will only fail validation once a writer has successfully acquired the lock (irrespective of queued writers)

Nested Class Summary

Nested classes/interfaces inherited from interface com.ibm.asyncutil.locks.AsyncReadWriteLock

AsyncReadWriteLock.ReadLockToken, AsyncReadWriteLock.WriteLockToken

Nested classes/interfaces inherited from interface com.ibm.asyncutil.locks.AsyncStampedLock

AsyncStampedLock.Stamp

Constructor Summary

Constructors

Constructor	Description
FairAsyncStampedLock()

Method Summary

Modifier and Type	Method	Description
AsyncStampedLock.Stamp	tryOptimisticRead()	Attempts to acquire a AsyncStampedLock.Stamp in optimistic-read mode if the lock is not already write-locked.

Methods inherited from interface com.ibm.asyncutil.locks.AsyncReadWriteLock

acquireReadLock, acquireWriteLock, tryReadLock, tryWriteLock

Methods inherited from interface com.ibm.asyncutil.locks.AsyncStampedLock

create, createFair

Methods inherited from class com.ibm.asyncutil.locks.FairAsyncReadWriteLock

acquireReadLock, acquireWriteLock, tryReadLock, tryWriteLock

Methods inherited from class java.lang.Object

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

Constructor Detail

FairAsyncStampedLock

public FairAsyncStampedLock()

Method Detail

tryOptimisticRead

public AsyncStampedLock.Stamp tryOptimisticRead()

Description copied from interface: AsyncStampedLock

Attempts to acquire a AsyncStampedLock.Stamp in optimistic-read mode if the lock is not already write-locked. The stamp may subsequently be validated to check whether the write lock has been acquired

Specified by:

tryOptimisticRead in interface AsyncStampedLock

Returns:

a non-null Stamp if the lock is not currently write-locked. Otherwise, returns null