reactor.bus.timer.EventTimer Maven / Gradle / Ivy
/*
* Copyright (c) 2011-2015 Pivotal Software Inc, All Rights Reserved.
*
* 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 reactor.bus.timer;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import reactor.bus.registry.Registration;
import reactor.bus.registry.Registries;
import reactor.bus.registry.Registry;
import reactor.bus.selector.HeaderResolver;
import reactor.bus.selector.Selector;
import reactor.core.processor.CancelException;
import reactor.core.support.Assert;
import reactor.core.support.NamedDaemonThreadFactory;
import reactor.core.support.ReactorFatalException;
import reactor.fn.Consumer;
import reactor.fn.timer.Timer;
import java.util.concurrent.TimeUnit;
/**
* A hashed wheel timer implementation that uses a {@link reactor.bus.registry.Registry} and custom {@link
* reactor.bus.selector.Selector Selectors} to determine when tasks should be executed.
*
* This is specifically useful when RingBuffer HashWheelTimer is not supported (Android).
*
* A {@code SimpleHashWheelTimer} has two variations for scheduling tasks: {@link #schedule(reactor.fn.Consumer,
* long,
* java.util.concurrent.TimeUnit)} and {@link #schedule(reactor.fn.Consumer, long, java.util.concurrent.TimeUnit,
* long)} which are for scheduling repeating tasks, and {@link #submit(reactor.fn.Consumer, long,
* java.util.concurrent.TimeUnit)} which is for scheduling single-run delayed tasks.
*
*
* To schedule a repeating task, specify the period of time which should elapse before invoking the given {@link
* reactor.fn.Consumer}. To schedule a task that repeats every 5 seconds, for example, one would do something
* like:
*
*
*
* SimpleHashWheelTimer timer = new SimpleHashWheelTimer();
*
* timer.schedule(new Consumer<Long>() {
* public void accept(Long now) {
* // run a task
* }
* }, 5, TimeUnit.SECONDS);
*
*
* NOTE: Without delaying a task, it will be run immediately, in addition to being run after the elapsed time has
* expired. To run a task only once every N time units and not immediately, use the {@link
* #schedule(reactor.fn.Consumer, long, java.util.concurrent.TimeUnit, long)} method, which allows you to specify
* an additional delay that must expire before the task will be executed.
*
*
* @author Jon Brisbin
* @author Stephane Maldini
*/
public class EventTimer implements Timer {
private static final Logger LOG = LoggerFactory.getLogger(EventTimer.class);
private final Registry> tasks = Registries.create(true, false, null);
private final int resolution;
private final Thread loop;
/**
* Create a new {@code SimpleHashWheelTimer} using the default resolution of 50ms.
*/
Timer create() {
return create(50);
}
/**
* Create a new {@code SimpleHashWheelTimer} using the given timer resolution. All times will rounded up to the
* closest
* multiple of this resolution.
*
* @param resolution
* the resolution of this timer, in milliseconds
*/
Timer create(final int resolution) {
return new EventTimer(resolution);
}
/**
* Create a new {@code SimpleHashWheelTimer} using the given timer resolution. All times will rounded up to the
* closest
* multiple of this resolution.
*
* @param resolution
* the resolution of this timer, in milliseconds
*/
private EventTimer(final int resolution) {
this.resolution = resolution;
this.loop = new NamedDaemonThreadFactory("simple-hash-wheel-timer").newThread(
new Runnable() {
@Override
public void run() {
while (!Thread.currentThread().isInterrupted()) {
long now = now(resolution);
for (Registration> reg : tasks.select(now)) {
try {
if (reg.isCancelled() || reg.isPaused()) {
continue;
}
reg.getObject().accept(now);
} catch (CancelException cce) {
reg.cancel();
} catch (Throwable t) {
LOG.error(t.getMessage(), t);
} finally {
if (reg.isCancelAfterUse()) {
reg.cancel();
}
}
}
try {
Thread.sleep(resolution);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
return;
}
}
}
}
);
this.loop.start();
}
@Override
public long getResolution() {
return resolution;
}
@Override
public Registration> schedule(Consumer consumer,
long period,
TimeUnit timeUnit,
long delayInMilliseconds) {
Assert.isTrue(!loop.isInterrupted(), "Cannot submit tasks to this timer as it has been cancelled.");
long milliPeriod = TimeUnit.MILLISECONDS.convert(period, timeUnit);
if(milliPeriod % resolution != 0){
throw ReactorFatalException.create(new IllegalArgumentException(
"Period must be a multiple of timer resolution (e.g. period % resolution == 0 )")
);
}
return tasks.register(
new PeriodSelector(milliPeriod, delayInMilliseconds, resolution),
consumer
);
}
@Override
public Registration> schedule(Consumer consumer,
long period,
TimeUnit timeUnit) {
return schedule(consumer, period, timeUnit, 0);
}
@Override
public Registration> submit(Consumer consumer,
long delay,
TimeUnit timeUnit) {
Assert.isTrue(!loop.isInterrupted(), "Cannot submit tasks to this timer as it has been cancelled.");
long ms = TimeUnit.MILLISECONDS.convert(delay, timeUnit);
return tasks.register(
new PeriodSelector(0l, ms, resolution),
consumer
).cancelAfterUse();
}
@Override
public Registration> submit(Consumer consumer) {
return submit(consumer, resolution, TimeUnit.MILLISECONDS);
}
@Override
public void cancel() {
this.loop.interrupt();
}
private static long now(int resolution) {
return (long)(Math.ceil(System.currentTimeMillis() / resolution) * resolution);
}
private static class PeriodSelector implements Selector {
private final long period;
private final long delay;
private final long createdMillis;
private final int resolution;
private PeriodSelector(long period, long delay, int resolution) {
this.period = period;
this.delay = delay;
this.resolution = resolution;
this.createdMillis = now(resolution);
}
@Override
public Object getObject() {
return period;
}
@Override
public boolean matches(Long key) {
long now = key;
long period = (long)(Math.ceil((now - createdMillis) / resolution) * resolution);
return period >= delay && period % this.period == 0;
}
@Override
public HeaderResolver getHeaderResolver() {
return null;
}
}
}