net.openhft.chronicle.queue.impl.single

Class TSQueueLock

java.lang.Object

net.openhft.chronicle.queue.impl.table.AbstractTSQueueLock

net.openhft.chronicle.queue.impl.single.TSQueueLock

All Implemented Interfaces:

Closeable, AutoCloseable, QueueLock

public class TSQueueLock
extends AbstractTSQueueLock
implements QueueLock

Implements queue lock via TableStore mechanism.

Field Summary

Fields inherited from class net.openhft.chronicle.queue.impl.table.AbstractTSQueueLock

lock, path, pauser, tableStore, UNLOCKED

Constructor Summary

Constructors

Constructor and Description
TSQueueLock(TableStore<?> tableStore, Supplier<net.openhft.chronicle.threads.TimingPauser> pauser, Long timeoutMs)

Method Summary

Modifier and Type	Method and Description
void	acquireLock() Stores current PID to table store, and any other process trying to acquire lock will wait for chronicle.queue.lock.timeoutMS millis (default is 30000) for the lock to be released, and if it is not after timeout, throws IllegalStateException.
void	unlock() Checks if the lock is held by current thread and if so, releases it, removing entry from TableStore and clearing ThreadLocal state, allowing anyone to proceed with ChronicleQueue.acquireAppender().
void	waitForLock() checks if current thread holds lock.

Methods inherited from class net.openhft.chronicle.queue.impl.table.AbstractTSQueueLock

close, closeCheck, forceUnlock

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.io.Closeable

close, closeQuietly, closeQuietly, isClosed, notifyClosing

Constructor Detail

TSQueueLock

public TSQueueLock(TableStore<?> tableStore,
                   Supplier<net.openhft.chronicle.threads.TimingPauser> pauser,
                   Long timeoutMs)

Method Detail

acquireLock

public void acquireLock()

Stores current PID to table store, and any other process trying to acquire lock will wait for chronicle.queue.lock.timeoutMS millis (default is 30000) for the lock to be released, and if it is not after timeout, throws IllegalStateException. Also the locking thread ID is stored in threadLocal field, so that only locking thread is allowed to ChronicleQueue.acquireAppender() while the queue is locked.

Specified by:

acquireLock in interface QueueLock

waitForLock

public void waitForLock()

checks if current thread holds lock. If not, it will wait for chronicle.queue.lock.timeoutMS millis for the lock to be released, and if it is not after timeout, throws IllegalStateException.

Specified by:

waitForLock in interface QueueLock

unlock

public void unlock()

Checks if the lock is held by current thread and if so, releases it, removing entry from TableStore and clearing ThreadLocal state, allowing anyone to proceed with ChronicleQueue.acquireAppender().

Specified by:

unlock in interface QueueLock