Package com.lmax.disruptor
Class LiteBlockingWaitStrategy
java.lang.Object
com.lmax.disruptor.LiteBlockingWaitStrategy
- All Implemented Interfaces:
WaitStrategy
Variation of the
BlockingWaitStrategy that attempts to elide conditional wake-ups when
the lock is uncontended. Shows performance improvements on microbenchmarks. However this
wait strategy should be considered experimental as I have not full proved the correctness of
the lock elision code.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final Lockprivate final Conditionprivate final AtomicBoolean -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidImplementations should signal the waitingEventProcessors that the cursor has advanced.toString()longwaitFor(long sequence, Sequence cursorSequence, Sequence dependentSequence, SequenceBarrier barrier) Wait for the given sequence to be available.
-
Field Details
-
lock
-
processorNotifyCondition
-
signalNeeded
-
-
Constructor Details
-
LiteBlockingWaitStrategy
public LiteBlockingWaitStrategy()
-
-
Method Details
-
waitFor
public long waitFor(long sequence, Sequence cursorSequence, Sequence dependentSequence, SequenceBarrier barrier) throws AlertException, InterruptedException Description copied from interface:WaitStrategyWait for the given sequence to be available. It is possible for this method to return a value less than the sequence number supplied depending on the implementation of the WaitStrategy. A common use for this is to signal a timeout. Any EventProcessor that is using a WaitStrategy to get notifications about message becoming available should remember to handle this case. TheBatchEventProcessorexplicitly handles this case and will signal a timeout if required.- Specified by:
waitForin interfaceWaitStrategy- Parameters:
sequence- to be waited on.cursorSequence- the main sequence from ringbuffer. Wait/notify strategies will need this as it's the only sequence that is also notified upon update.dependentSequence- on which to wait.barrier- the processor is waiting on.- Returns:
- the sequence that is available which may be greater than the requested sequence.
- Throws:
AlertException- if the status of the Disruptor has changed.InterruptedException- if the thread is interrupted.
-
signalAllWhenBlocking
public void signalAllWhenBlocking()Description copied from interface:WaitStrategyImplementations should signal the waitingEventProcessors that the cursor has advanced.- Specified by:
signalAllWhenBlockingin interfaceWaitStrategy
-
toString
-