DOC: Update Durable Mailboxes Chapter. See #1472

akka-docs/modules/code/akka/docs/actor/mailbox/DurableMailboxDocSpec.scala

@@ -0,0 +1,31 @@
+package akka.docs.actor.mailbox
+
+//#imports
+import akka.actor.Actor
+import akka.actor.Props
+import akka.actor.mailbox.FileDurableMailboxType
+
+//#imports
+
+import org.scalatest.{ BeforeAndAfterAll, WordSpec }
+import org.scalatest.matchers.MustMatchers
+import akka.testkit.AkkaSpec
+
+class MyActor extends Actor {
+  def receive = {
+    case x ⇒
+  }
+}
+
+class DurableMailboxDocSpec extends AkkaSpec {
+
+  "define dispatcher with durable mailbox" in {
+    //#define-dispatcher
+    val dispatcher = system.dispatcherFactory.newDispatcher(
+      "my-dispatcher", throughput = 1, mailboxType = FileDurableMailboxType).build
+    val myActor = system.actorOf(Props[MyActor].withDispatcher(dispatcher), name = "myactor")
+    //#define-dispatcher
+    myActor ! "hello"
+  }
+
+}

akka-docs/modules/code/akka/docs/actor/mailbox/DurableMailboxDocTest.scala

@@ -0,0 +1,5 @@
+package akka.docs.actor.mailbox
+
+import org.scalatest.junit.JUnitSuite
+
+class DurableMailboxDocTest extends DurableMailboxDocTestBase with JUnitSuite

akka-docs/modules/code/akka/docs/actor/mailbox/DurableMailboxDocTestBase.java

@@ -0,0 +1,41 @@
+package akka.docs.actor.mailbox;
+
+//#imports
+import akka.actor.mailbox.DurableMailboxType;
+import akka.dispatch.MessageDispatcher;
+import akka.actor.UntypedActorFactory;
+import akka.actor.UntypedActor;
+import akka.actor.Props;
+
+//#imports
+
+import org.junit.Test;
+
+import akka.actor.ActorRef;
+import akka.actor.ActorSystem;
+
+import static org.junit.Assert.*;
+
+public class DurableMailboxDocTestBase {
+
+  @Test
+  public void defineDispatcher() {
+    ActorSystem system = ActorSystem.create("MySystem");
+    //#define-dispatcher
+    MessageDispatcher dispatcher = system.dispatcherFactory()
+        .newDispatcher("my-dispatcher", 1, DurableMailboxType.fileDurableMailboxType()).build();
+    ActorRef myActor = system.actorOf(new Props().withDispatcher(dispatcher).withCreator(new UntypedActorFactory() {
+      public UntypedActor create() {
+        return new MyUntypedActor();
+      }
+    }));
+    //#define-dispatcher
+    myActor.tell("test");
+    system.stop();
+  }
+
+  public static class MyUntypedActor extends UntypedActor {
+    public void onReceive(Object message) {
+    }
+  }
+}