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
EventProcessors 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 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
-
-
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: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
-