org.springframework.integration.util
Class DefaultLockRegistry

java.lang.Object
  org.springframework.integration.util.DefaultLockRegistry

All Implemented Interfaces:

LockRegistry

public final class DefaultLockRegistry
extends java.lang.Object
implements LockRegistry

Default implementation of LockRegistry which uses Masked Hashcode algorithm to obtain locks. When an instance of this class is created and array of Lock objects is created. The length of the array is based on the 'mask' parameter passed in the constructor. The default mask is 0xFF which will create and array consisting of 256 ReentrantLock instances. When the obtain(Object) method is called with the lockKey (e.g., Object) the index of the Lock is determined by masking the object's hashCode (e.g., object.hashCode & mask) and the Lock is returned.

Since:

2.1.1

Author:

Oleg Zhurakousky, Gary Russell

Constructor Summary

DefaultLockRegistry()
Constructs a DefaultLockRegistry with the default mask 0xFF with 256 locks.

DefaultLockRegistry(int mask)
Constructs a DefaultLockRegistry with the supplied mask - the mask must have a value Math.pow(2, n) - 1 where n is 1 to 31, creating a hash of Math.pow(2, n) locks.

Method Summary

java.util.concurrent.locks.Lock

obtain(java.lang.Object lockKey) Obtains a lock by masking the lockKey's hashCode() with the mask and using the result as an index to the lock table.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultLockRegistry

public DefaultLockRegistry()

Constructs a DefaultLockRegistry with the default mask 0xFF with 256 locks.

DefaultLockRegistry

public DefaultLockRegistry(int mask)

Constructs a DefaultLockRegistry with the supplied mask - the mask must have a value Math.pow(2, n) - 1 where n is 1 to 31, creating a hash of Math.pow(2, n) locks.

Examples:

0x3ff (1023) - 1024 locks

0xfff (4095) - 4096 locks

Parameters:

mask -

Method Detail

obtain

public java.util.concurrent.locks.Lock obtain(java.lang.Object lockKey)

Obtains a lock by masking the lockKey's hashCode() with the mask and using the result as an index to the lock table.

Specified by:

obtain in interface LockRegistry

Parameters:

lockKey - the object used to derive the lock index.

Returns:

The associated lock.