info.aduna.concurrent.locks
Class ReadPrefReadWriteLockManager

java.lang.Object
  info.aduna.concurrent.locks.ReadPrefReadWriteLockManager

All Implemented Interfaces:

ReadWriteLockManager

public class ReadPrefReadWriteLockManager
extends Object
implements ReadWriteLockManager

A read/write lock manager with reader preference. This lock manager block any requests for write locks until all read locks have been released.

Author:

Arjohn Kampman

Constructor Summary

ReadPrefReadWriteLockManager()
Creates a MultiReadSingleWriteLockManager.

ReadPrefReadWriteLockManager(boolean trackLocks)
Creates a new MultiReadSingleWriteLockManager, optionally with lock tracking enabled.

Method Summary

Lock	getReadLock() Gets a read lock.
Lock	getWriteLock() Gets an exclusive write lock.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReadPrefReadWriteLockManager

public ReadPrefReadWriteLockManager()

Creates a MultiReadSingleWriteLockManager.

ReadPrefReadWriteLockManager

public ReadPrefReadWriteLockManager(boolean trackLocks)

Creates a new MultiReadSingleWriteLockManager, optionally with lock tracking enabled.

Parameters:

trackLocks - Controls whether the lock manager will keep track of active locks. Enabling lock tracking will add some overhead, but can be very useful for debugging.

Method Detail

getReadLock

public Lock getReadLock()
                 throws InterruptedException

Gets a read lock. This method blocks when a write lock is in use or has been requested until the write lock is released.

Specified by:

getReadLock in interface ReadWriteLockManager

Throws:

InterruptedException - In case the thread requesting the lock was interrupted.

getWriteLock

public Lock getWriteLock()
                  throws InterruptedException

Gets an exclusive write lock. This method blocks when the write lock is in use or has already been requested until the write lock is released. This method also block when read locks are active until all of them are released.

Specified by:

getWriteLock in interface ReadWriteLockManager

Throws:

InterruptedException - In case the thread requesting the lock was interrupted.