Package com.lmax.disruptor
Class BlockingWaitStrategy
java.lang.Object
com.lmax.disruptor.BlockingWaitStrategy
- All Implemented Interfaces:
WaitStrategy
Blocking strategy that uses a lock and condition variable for
EventProcessor
s waiting on a barrier.
This strategy can be used when throughput and low-latency are not as important as CPU resource.
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Implementations should signal the waitingEventProcessor
s that the cursor has advanced.toString()
long
waitFor
(long sequence, Sequence cursorSequence, Sequence dependentSequence, SequenceBarrier barrier) Wait for the given sequence to be available.
-
Field Details
-
lock
-
processorNotifyCondition
-
-
Constructor Details
-
BlockingWaitStrategy
public BlockingWaitStrategy()
-
-
Method Details
-
waitFor
public long waitFor(long sequence, Sequence cursorSequence, Sequence dependentSequence, SequenceBarrier barrier) throws AlertException, InterruptedException Description copied from interface:WaitStrategy
Wait 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. TheBatchEventProcessor
explicitly handles this case and will signal a timeout if required.- Specified by:
waitFor
in 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:WaitStrategy
Implementations should signal the waitingEventProcessor
s that the cursor has advanced.- Specified by:
signalAllWhenBlocking
in interfaceWaitStrategy
-
toString
-