com.sleepycat.je.latch

Class TimingLatch

java.lang.Object

java.util.concurrent.locks.ReentrantLock

com.sleepycat.je.latch.LatchImpl

com.sleepycat.je.latch.TimingLatch

All Implemented Interfaces:

Latch, SharedLatch, Serializable, Lock

public class TimingLatch
extends LatchImpl

A subclass of Latch that may be used for debugging performance issues. This latch can be used in place of an exclusive latch or object mutex in order to see who is waiting for a latch acquisition, how long they're waiting, and who the previous holder was. It crudely writes to System.out, but this can easily be changed to a java.util.Log or EventTrace as desired. You can specify a threshold for the wait and previous holder time (nanos). Note that this class has not recently been used because it is not implemented for shared (Btree) latches. The next time it is used, it should be integrated with the LatchFactory.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TimingLatch.AcquireCompleteEvent
class	TimingLatch.AcquireRequestEvent
class	TimingLatch.ReleaseEvent

Constructor Summary

Constructors

Constructor and Description
TimingLatch(LatchContext context, boolean debug)
TimingLatch(LatchContext context, boolean debug, int waitThreshold, int holdThreshold)

Method Summary

Modifier and Type	Method and Description
void	acquireExclusive() Acquires a latch for exclusive/write access.
void	release() Releases the latch.

Methods inherited from class com.sleepycat.je.latch.LatchImpl

acquireExclusiveNoWait, acquireShared, clearStats, debugString, getExclusiveOwner, getNWaiters, getStats, isExclusiveOnly, isExclusiveOwner, isOwner, releaseIfOwner, toString

Methods inherited from class java.util.concurrent.locks.ReentrantLock

getHoldCount, getOwner, getQueuedThreads, getQueueLength, getWaitingThreads, getWaitQueueLength, hasQueuedThread, hasQueuedThreads, hasWaiters, isFair, isHeldByCurrentThread, isLocked, lock, lockInterruptibly, newCondition, tryLock, tryLock, unlock

Methods inherited from class java.lang.Object

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

Constructor Detail

TimingLatch

public TimingLatch(LatchContext context,
                   boolean debug)

TimingLatch

public TimingLatch(LatchContext context,
                   boolean debug,
                   int waitThreshold,
                   int holdThreshold)

Method Detail

release

public void release()

Description copied from interface: Latch

Releases the latch. If there are other thread(s) waiting for the latch, they are woken up and granted the latch.

Specified by:

release in interface Latch

Overrides:

release in class LatchImpl

acquireExclusive

public void acquireExclusive()

Description copied from interface: Latch

Acquires a latch for exclusive/write access.

Specified by:

acquireExclusive in interface Latch

Overrides:

acquireExclusive in class LatchImpl