de.aristaflow.adept2.util.locking

Class ObjectEqualityLockCount

java.lang.Object

de.aristaflow.adept2.util.ObjectCounting<java.lang.Object>

de.aristaflow.adept2.util.locking.ObjectEqualityLockCount

All Implemented Interfaces:

LockCountManager<java.lang.Object>

public class ObjectEqualityLockCount
extends ObjectCounting<java.lang.Object>
implements LockCountManager<java.lang.Object>

A LockCountManager counting objects using Object.equals(Object) and Object.hashCode().

Author:

Ulrich Kreher

Field Summary

Fields inherited from class de.aristaflow.adept2.util.ObjectCounting

logger, objectCount

Constructor Summary

Constructors

Constructor and Description
ObjectEqualityLockCount() Creates a new LockCountManager for objects using Object.equals(Object) and Object.hashCode().

Method Summary

Modifier and Type	Method and Description
int	decreaseAndGetLockCount(java.lang.Object object) Decreases the number of times the designated object holds the lock.
java.lang.String	getLockOwner() Returns a string representation of one object that currently has a lock.
boolean	hasLock(java.lang.Object object) Returns whether the designated object has a lock at least once.
boolean	hasLocks() Returns whether this lock count manager knows at least one object that has a lock.
int	increaseAndGetLockCount(java.lang.Object object) Increases the number of times the designated object holds the lock.

Methods inherited from class de.aristaflow.adept2.util.ObjectCounting

decreaseAndGetCount, getCount, increaseAndGetCount, isEmpty

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectEqualityLockCount

public ObjectEqualityLockCount()

Creates a new LockCountManager for objects using Object.equals(Object) and Object.hashCode().

Method Detail

hasLock

public boolean hasLock(java.lang.Object object)

Description copied from interface: LockCountManager

Returns whether the designated object has a lock at least once.

Specified by:

hasLock in interface LockCountManager<java.lang.Object>

Parameters:

object - The object which is checked whether it holds a lock.

Returns:

Whether the designated object has a lock at least once.

hasLocks

public boolean hasLocks()

Description copied from interface: LockCountManager

Returns whether this lock count manager knows at least one object that has a lock.

Specified by:

hasLocks in interface LockCountManager<java.lang.Object>

Returns:

Whether at least one object has a lock.

getLockOwner

public java.lang.String getLockOwner()

Description copied from interface: LockCountManager

Returns a string representation of one object that currently has a lock. This can be used for user information or tracking purpose. A locking object may not be returned since this would allow to unlock.

Specified by:

getLockOwner in interface LockCountManager<java.lang.Object>

Returns:

A string representation of one object that currently has a lock.

increaseAndGetLockCount

public int increaseAndGetLockCount(java.lang.Object object)

Description copied from interface: LockCountManager

Increases the number of times the designated object holds the lock.

Specified by:

increaseAndGetLockCount in interface LockCountManager<java.lang.Object>

Parameters:

object - The object which has acquired the lock (once again).

Returns:

The number of times the designated object has the lock after the increment.

decreaseAndGetLockCount

public int decreaseAndGetLockCount(java.lang.Object object)

Description copied from interface: LockCountManager

Decreases the number of times the designated object holds the lock. If the object does not hold the lock, the decrement will be ignored.

Specified by:

decreaseAndGetLockCount in interface LockCountManager<java.lang.Object>

Parameters:

object - The object which has released the lock (once again).

Returns:

The number of times the designated object has the lock after the decrement.