/
PhasedBackoffWaitStrategy.java
149 lines (139 loc) · 5.02 KB
/
PhasedBackoffWaitStrategy.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
/*
* Copyright 2011 LMAX Ltd.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.lmax.disruptor;
import java.util.concurrent.TimeUnit;
/**
* Phased wait strategy for waiting {@link EventProcessor}s on a barrier.
*
* <p>This strategy can be used when throughput and low-latency are not as important as CPU resource.
* Spins, then yields, then waits using the configured fallback WaitStrategy.
*/
public final class PhasedBackoffWaitStrategy implements WaitStrategy
{
private static final int SPIN_TRIES = 10000;
private final long spinTimeoutNanos;
private final long yieldTimeoutNanos;
private final WaitStrategy fallbackStrategy;
/**
*
* @param spinTimeout The maximum time in to busy spin for.
* @param yieldTimeout The maximum time in to yield for.
* @param units Time units used for the timeout values.
* @param fallbackStrategy After spinning + yielding, the strategy to fall back to
*/
public PhasedBackoffWaitStrategy(
final long spinTimeout,
final long yieldTimeout,
final TimeUnit units,
final WaitStrategy fallbackStrategy)
{
this.spinTimeoutNanos = units.toNanos(spinTimeout);
this.yieldTimeoutNanos = spinTimeoutNanos + units.toNanos(yieldTimeout);
this.fallbackStrategy = fallbackStrategy;
}
/**
* Construct {@link PhasedBackoffWaitStrategy} with fallback to {@link BlockingWaitStrategy}
*
* @param spinTimeout The maximum time in to busy spin for.
* @param yieldTimeout The maximum time in to yield for.
* @param units Time units used for the timeout values.
* @return The constructed wait strategy.
*/
public static PhasedBackoffWaitStrategy withLock(
final long spinTimeout,
final long yieldTimeout,
final TimeUnit units)
{
return new PhasedBackoffWaitStrategy(
spinTimeout, yieldTimeout,
units, new BlockingWaitStrategy());
}
/**
* Construct {@link PhasedBackoffWaitStrategy} with fallback to {@link LiteBlockingWaitStrategy}
*
* @param spinTimeout The maximum time in to busy spin for.
* @param yieldTimeout The maximum time in to yield for.
* @param units Time units used for the timeout values.
* @return The constructed wait strategy.
*/
public static PhasedBackoffWaitStrategy withLiteLock(
final long spinTimeout,
final long yieldTimeout,
final TimeUnit units)
{
return new PhasedBackoffWaitStrategy(
spinTimeout, yieldTimeout,
units, new LiteBlockingWaitStrategy());
}
/**
* Construct {@link PhasedBackoffWaitStrategy} with fallback to {@link SleepingWaitStrategy}
*
* @param spinTimeout The maximum time in to busy spin for.
* @param yieldTimeout The maximum time in to yield for.
* @param units Time units used for the timeout values.
* @return The constructed wait strategy.
*/
public static PhasedBackoffWaitStrategy withSleep(
final long spinTimeout,
final long yieldTimeout,
final TimeUnit units)
{
return new PhasedBackoffWaitStrategy(
spinTimeout, yieldTimeout,
units, new SleepingWaitStrategy(0));
}
@Override
public long waitFor(final long sequence, final Sequence cursor, final Sequence dependentSequence, final SequenceBarrier barrier)
throws AlertException, InterruptedException, TimeoutException
{
long availableSequence;
long startTime = 0;
int counter = SPIN_TRIES;
do
{
if ((availableSequence = dependentSequence.get()) >= sequence)
{
return availableSequence;
}
if (0 == --counter)
{
if (0 == startTime)
{
startTime = System.nanoTime();
}
else
{
long timeDelta = System.nanoTime() - startTime;
if (timeDelta > yieldTimeoutNanos)
{
return fallbackStrategy.waitFor(sequence, cursor, dependentSequence, barrier);
}
else if (timeDelta > spinTimeoutNanos)
{
Thread.yield();
}
}
counter = SPIN_TRIES;
}
}
while (true);
}
@Override
public void signalAllWhenBlocking()
{
fallbackStrategy.signalAllWhenBlocking();
}
}