org.agrona.concurrent

Class BusySpinIdleStrategy

java.lang.Object

org.agrona.concurrent.BusySpinIdleStrategy

All Implemented Interfaces:

IdleStrategy

public final class BusySpinIdleStrategy
extends java.lang.Object
implements IdleStrategy

Busy spin strategy targeted at lowest possible latency. This strategy will monopolise a thread to achieve the lowest possible latency. Useful for creating bubbles in the execution pipeline of tight busy spin loops with no other logic than status checks on progress.

Constructor Summary

Constructors

Constructor and Description
BusySpinIdleStrategy()

Method Summary

Modifier and Type	Method and Description
void	idle() Perform current idle action (e.g.
void	idle(int workCount) Note: this implementation will result in no safepoint poll once inlined.
void	reset() Reset the internal state in preparation for entering an idle state again.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BusySpinIdleStrategy

public BusySpinIdleStrategy()

Method Detail

idle

public void idle(int workCount)

Note: this implementation will result in no safepoint poll once inlined.

Specified by:

idle in interface IdleStrategy

Parameters:

workCount - performed in last duty cycle.

See Also:

IdleStrategy.idle(int)

idle

public void idle()

Description copied from interface: IdleStrategy

Perform current idle action (e.g. nothing/yield/sleep). To be used in conjunction with IdleStrategy.reset() to clear internal state when idle period is over (or before it begins). Callers are expected to follow this pattern:

 
 while (isRunning)
 {
   if (!hasWork())
   {
     idleStrategy.reset();
     while (!hasWork())
     {
       if (!isRunning)
       {
         return;
       }
       idleStrategy.idle();
     }
   }
   doWork();
 }
 
 

Specified by:

idle in interface IdleStrategy

reset

public void reset()

Description copied from interface: IdleStrategy

Reset the internal state in preparation for entering an idle state again.

Specified by:

reset in interface IdleStrategy

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object