LightArrayRevolverScheduler, see #2904

- based on a wheel (AtomicReferenceArray) from which atomic
  single-linked lists dangle
- no locks
- deterministic tests due to overridable time source
- also bring docs up to date

akka-docs/rst/java/code/docs/actor/SchedulerDocTestBase.java

@@ -10,6 +10,7 @@ import java.util.concurrent.TimeUnit;
 //#imports1
 
 //#imports2
+import akka.actor.Actor;
 import akka.actor.UntypedActor;
 import akka.actor.UntypedActorFactory;
 import akka.actor.Cancellable;
@@ -43,7 +44,7 @@ public class SchedulerDocTestBase {
   public void scheduleOneOffTask() {
     //#schedule-one-off-message
     system.scheduler().scheduleOnce(Duration.create(50, TimeUnit.MILLISECONDS),
-      testActor, "foo", system.dispatcher());
+      testActor, "foo", system.dispatcher(), null);
     //#schedule-one-off-message
 
     //#schedule-one-off-thunk

akka-docs/rst/java/code/docs/actor/japi/FaultHandlingDocSample.java

@@ -311,9 +311,8 @@ public class FaultHandlingDocSample {
         counter.tell(new UseStorage(null), getSelf());
         // Try to re-establish storage after while
         getContext().system().scheduler().scheduleOnce(
-                Duration.create(10, "seconds"), getSelf(), Reconnect,
-          getContext().dispatcher()
-        );
+            Duration.create(10, "seconds"), getSelf(), Reconnect,
+            getContext().dispatcher(), null);
       } else if (msg.equals(Reconnect)) {
         // Re-establish storage after the scheduled delay
         initStorage();

akka-docs/rst/java/code/docs/pattern/SchedulerPatternTest.java

@@ -84,7 +84,7 @@ public class SchedulerPatternTest {
     public void preStart() {
       getContext().system().scheduler().scheduleOnce(
         Duration.create(500, TimeUnit.MILLISECONDS),
-        getSelf(), "tick", getContext().dispatcher());
+        getSelf(), "tick", getContext().dispatcher(), null);
     }
 
     // override postRestart so we don't call preStart and schedule a new message
@@ -98,7 +98,7 @@ public class SchedulerPatternTest {
         // send another periodic tick after the specified delay
         getContext().system().scheduler().scheduleOnce(
           Duration.create(1000, TimeUnit.MILLISECONDS),
-          getSelf(), "tick", getContext().dispatcher());
+          getSelf(), "tick", getContext().dispatcher(), null);
         // do something useful here
         //#schedule-receive
         target.tell(message, getSelf());

akka-docs/rst/java/code/docs/pattern/SupervisedAsk.java

@@ -5,6 +5,7 @@ import java.util.concurrent.TimeoutException;
 import scala.concurrent.Future;
 import scala.concurrent.duration.Duration;
 
+import akka.actor.Actor;
 import akka.actor.ActorKilledException;
 import akka.actor.ActorRef;
 import akka.actor.ActorRefFactory;
@@ -79,7 +80,7 @@ public class SupervisedAsk {
         targetActor.forward(askParam.message, getContext());
         Scheduler scheduler = getContext().system().scheduler();
         timeoutMessage = scheduler.scheduleOnce(askParam.timeout.duration(),
-            self(), new AskTimeout(), context().dispatcher());
+            self(), new AskTimeout(), context().dispatcher(), null);
       } else if (message instanceof Terminated) {
         Throwable ex = new ActorKilledException("Target actor terminated.");
         caller.tell(new Status.Failure(ex), self());