From 0afc3b17213d9a2a80232b1121ae4a99e4507545 Mon Sep 17 00:00:00 2001
From: Roland <rk@rkuhn.info>
Date: Thu, 27 Sep 2012 15:57:46 +0200
Subject: [PATCH] add ReliableProxy pattern to demo akka-contrib

---
 akka-contrib/README.md                        |   8 +-
 akka-contrib/docs/ReliableProxy.png           | Bin 0 -> 32304 bytes
 akka-contrib/docs/index.rst                   |  66 ++++++
 akka-contrib/docs/reliable-proxy.rst          |  92 ++++++++
 .../akka/contrib/pattern/ReliableProxy.scala  | 167 +++++++++++++++
 .../contrib/pattern/ReliableProxySpec.scala   | 196 ++++++++++++++++++
 .../contrib/pattern/ReliableProxyTest.java    | 123 +++++++++++
 .../pattern/ReliableProxyDocSpec.scala        |  41 ++++
 akka-docs/rst/experimental/index.rst          |  14 +-
 project/AkkaBuild.scala                       |  78 +++----
 10 files changed, 731 insertions(+), 54 deletions(-)
 create mode 100644 akka-contrib/docs/ReliableProxy.png
 create mode 100644 akka-contrib/docs/index.rst
 create mode 100644 akka-contrib/docs/reliable-proxy.rst
 create mode 100644 akka-contrib/src/main/scala/akka/contrib/pattern/ReliableProxy.scala
 create mode 100644 akka-contrib/src/multi-jvm/scala/akka/contrib/pattern/ReliableProxySpec.scala
 create mode 100644 akka-contrib/src/test/java/akka/contrib/pattern/ReliableProxyTest.java
 create mode 100644 akka-contrib/src/test/scala/akka/contrib/pattern/ReliableProxyDocSpec.scala

diff --git a/akka-contrib/README.md b/akka-contrib/README.md
index c01a24d7c8..ced22e74f3 100644
--- a/akka-contrib/README.md
+++ b/akka-contrib/README.md
@@ -14,8 +14,12 @@ A module in this subproject doesn't have to obey the rule of staying binary comp
 
 ## Suggested Format of Contributions
 
-Each contribution should be a self-contained unit, consisting of one source file without dependencies to other modules in this subproject (it may depend on anything else in the Akka distribution, though). This ensures that contributions may be moved into the standard distribution individually.
+Each contribution should be a self-contained unit, consisting of one source file or one exclusively used package, without dependencies to other modules in this subproject; it may depend on everything else in the Akka distribution, though. This ensures that contributions may be moved into the standard distribution individually. The module shall be within a subpackage of `akka.contrib`.
+
+Each module must be accompanied by a test suite which verifies that the provided features work, possibly complemented by integration and unit tests. The tests should follow the [Developer Guidelines](http://doc.akka.io/docs/akka/current/dev/developer-guidelines.html#testing) and go into the `src/test/scala` or `src/test/java` directories (with package name matching the module which is being tested). As an example, if the module were called `akka.contrib.pattern.ReliableProxy`, then the test suite should be called `akka.contrib.pattern.ReliableProxySpec`.
+
+Each module must also have proper documentation in [reStructured Text format](http://sphinx.pocoo.org/rest.html). The documentation should be a single `<module>.rst` file in the `akka-contrib/docs` directory, including a link from `index.rst`.
 
 ## Suggested Way of Using these Contributions
 
-Since the Akka team does not restrict updates to this subproject even during otherwise binary compatible releases, and modules may be removed without deprecation, it is suggested to copy the source files into your own code base, changing the package name. This way you can choose when to update or which fixes to include (to keep binary compatibility if needed) and later releases of Akka do not potentially break your application.
\ No newline at end of file
+Since the Akka team does not restrict updates to this subproject even during otherwise binary compatible releases, and modules may be removed without deprecation, it is suggested to copy the source files into your own code base, changing the package name. This way you can choose when to update or which fixes to include (to keep binary compatibility if needed) and later releases of Akka do not potentially break your application.
diff --git a/akka-contrib/docs/ReliableProxy.png b/akka-contrib/docs/ReliableProxy.png
new file mode 100644
index 0000000000000000000000000000000000000000..81575fd9f24d28dee5f4fe62fb157a31b03ee7bc
GIT binary patch
literal 32304
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

literal 0
HcmV?d00001

diff --git a/akka-contrib/docs/index.rst b/akka-contrib/docs/index.rst
new file mode 100644
index 0000000000..9f5b57c513
--- /dev/null
+++ b/akka-contrib/docs/index.rst
@@ -0,0 +1,66 @@
+External Contributions
+======================
+
+This subproject provides a home to modules contributed by external developers
+which may or may not move into the officially supported code base over time.
+The conditions under which this transition can occur include:
+
+* there must be enough interest in the module to warrant inclusion in the
+  standard distribution,
+* the module must be actively maintained and
+* code quality must be good enough to allow efficient maintenance by the Akka
+  core development team
+
+If a contributions turns out to not “take off” it may be removed again at a
+later time.
+
+Caveat Emptor
+-------------
+
+A module in this subproject doesn't have to obey the rule of staying binary
+compatible between minor releases. Breaking API changes may be introduced in
+minor releases without notice as we refine and simplify based on your feedback.
+A module may be dropped in any release without prior deprecation. The Typesafe
+subscription does not cover support for these modules.
+
+The Current List of Modules
+---------------------------
+
+.. toctree::
+
+   reliable-proxy
+
+Suggested Way of Using these Contributions
+------------------------------------------
+
+Since the Akka team does not restrict updates to this subproject even during
+otherwise binary compatible releases, and modules may be removed without
+deprecation, it is suggested to copy the source files into your own code base,
+changing the package name. This way you can choose when to update or which
+fixes to include (to keep binary compatibility if needed) and later releases of
+Akka do not potentially break your application.
+
+Suggested Format of Contributions
+---------------------------------
+
+Each contribution should be a self-contained unit, consisting of one source
+file or one exclusively used package, without dependencies to other modules in
+this subproject; it may depend on everything else in the Akka distribution,
+though. This ensures that contributions may be moved into the standard
+distribution individually. The module shall be within a subpackage of
+``akka.contrib``.
+
+Each module must be accompanied by a test suite which verifies that the
+provided features work, possibly complemented by integration and unit tests.
+The tests should follow the :ref:`developer_guidelines` and go into the
+``src/test/scala`` or ``src/test/java`` directories (with package name matching
+the module which is being tested). As an example, if the module were called
+``akka.contrib.pattern.ReliableProxy``, then the test suite should be called
+``akka.contrib.pattern.ReliableProxySpec``.
+
+Each module must also have proper documentation in `reStructured Text`_ format.
+The documentation should be a single ``<module>.rst`` file in the
+``akka-contrib/docs`` directory, including a link from ``index.rst`` (this file).
+
+.. _reStructured Text: http://sphinx.pocoo.org/rest.html
+
diff --git a/akka-contrib/docs/reliable-proxy.rst b/akka-contrib/docs/reliable-proxy.rst
new file mode 100644
index 0000000000..add4fa0340
--- /dev/null
+++ b/akka-contrib/docs/reliable-proxy.rst
@@ -0,0 +1,92 @@
+Reliable Proxy Pattern
+======================
+
+Looking at :ref:`message-send-semantics` one might come to the conclusion that
+Akka actors are made for blue-sky scenarios: sending messages is the only way
+for actors to communicate, and then that is not even guaranteed to work. Is the
+whole paradigm built on sand? Of course the answer is an emphatic “No!”.
+
+A local message send—within the same JVM instance—is not likely to fail, and if
+it does the reason was one of
+
+* it was meant to fail (due to consciously choosing a bounded mailbox, which
+  upon overflow will have to drop messages)
+* or it failed due to a catastrophic VM error, e.g. an
+  :class:`OutOfMemoryError`, a memory access violation (“segmentation fault”,
+  GPF, etc.), JVM bug—or someone calling ``System.exit()``.
+
+In all of these cases, the actor was very likely not in a position to process
+the message anyway, so this part of the non-guarantee is not problematic.
+
+It is a lot more likely for an unintended message delivery failure to occur
+when a message send crosses JVM boundaries, i.e. an intermediate unreliable
+network is involved. If someone unplugs an ethernet cable, or a power failure
+shuts down a router, messages will be lost while the actors would be able to
+process them just fine.
+
+.. note::
+
+   This does not mean that message send semantics are different between local
+   and remote operations, it just means that in practice there is a difference
+   between how good the “best effort” is.
+
+Introducing the Reliable Proxy
+------------------------------
+
+.. image:: ReliableProxy.png
+
+To bridge the disparity between “local” and “remote” sends is the goal of this
+pattern. When sending from A to B must be as reliable as in-JVM, regardless of
+the deployment, then you can interject a reliable tunnel and send through that
+instead. The tunnel consists of two end-points, where the ingress point P (the
+“proxy”) is a child of A and the egress point E is a child of P, deployed onto
+the same network node where B lives. Messages sent to P will be wrapped in an
+envelope, tagged with a sequence number and sent to E, who verifies that the
+received envelope has the right sequence number (the next expected one) and
+forwards the contained message to B. When B receives this message, the
+``sender`` will be a reference to the sender of the original message to P.
+Reliability is added by E replying to orderly received messages with an ACK, so
+that P can tick those messages off its resend list. If ACKs do not come in a
+timely fashion, P will try to resend until successful.
+
+Exactly what does it guarantee?
+-------------------------------
+
+Sending via a :class:`ReliableProxy` makes the message send exactly as reliable
+as if the represented target were to live within the same JVM, provided that
+the remote actor system does not terminate. In effect, both ends (i.e. JVM and
+actor system) must be considered as one when evaluating the reliability of this
+communication channel. The benefit is that the network in-between is taken out
+of that equation.
+
+When the target actor terminates, the proxy will terminate as well (on the
+terms of :ref:`deathwatch-java` / :ref:`deathwath-scala`).
+
+How to use it
+-------------
+
+Since this implementation does not offer much in the way of configuration,
+simply instantiate a proxy wrapping some target reference. From Java it looks
+like this:
+
+.. includecode:: ../src/test/java/akka/contrib/pattern/ReliableProxyTest.java#imports
+.. includecode:: ../src/test/java/akka/contrib/pattern/ReliableProxyTest.java#demo-proxy
+
+And from Scala like this:
+
+.. includecode:: ../src/multi-jvm/scala/akka/contrib/pattern/ReliableProxySpec.scala#demo
+
+Since the :class:`ReliableProxy` actor is an :ref:`fsm-scala`, it also offers
+the capability to subscribe to state transitions. If you need to know when all
+enqueued messages have been received by the remote end-point (and consequently
+been forwarded to the target), you can subscribe to the FSM notifications and
+observe a transition from state :class:`ReliableProxy.Active` to state
+:class:`ReliableProxy.Idle`.
+
+.. includecode:: ../src/test/java/akka/contrib/pattern/ReliableProxyTest.java#demo-transition
+
+From Scala it would look like so:
+
+.. includecode:: ../src/test/scala/akka/contrib/pattern/ReliableProxyDocSpec.scala#demo-transition
+
+
diff --git a/akka-contrib/src/main/scala/akka/contrib/pattern/ReliableProxy.scala b/akka-contrib/src/main/scala/akka/contrib/pattern/ReliableProxy.scala
new file mode 100644
index 0000000000..d46eff9f5f
--- /dev/null
+++ b/akka-contrib/src/main/scala/akka/contrib/pattern/ReliableProxy.scala
@@ -0,0 +1,167 @@
+/**
+ * Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.contrib.pattern
+
+import akka.actor._
+import akka.remote.RemoteScope
+import scala.concurrent.util._
+
+object ReliableProxy {
+
+  class Receiver(target: ActorRef) extends Actor with ActorLogging {
+    var lastSerial = 0
+
+    context.watch(target)
+
+    def receive = {
+      case Message(msg, snd, serial) ⇒
+        if (serial == lastSerial + 1) {
+          target.tell(msg, snd)
+          sender ! Ack(serial)
+          lastSerial = serial
+        } else if (compare(serial, lastSerial) <= 0) {
+          sender ! Ack(serial)
+        } else {
+          log.debug("received msg of {} from {} with wrong serial", msg.asInstanceOf[AnyRef].getClass, snd)
+        }
+      case Terminated(`target`) ⇒ context stop self
+    }
+  }
+
+  /**
+   * Wrap-around aware comparison of integers: differences limited to 2^31-1
+   * in magnitude will work correctly.
+   */
+  def compare(a: Int, b: Int): Int = (a - b) match {
+    case x if x < 0  ⇒ -1
+    case x if x == 0 ⇒ 0
+    case x if x > 0  ⇒ 1
+  }
+
+  case class Message(msg: Any, sender: ActorRef, serial: Int)
+  case class Ack(serial: Int)
+  case object Tick
+
+  def receiver(target: ActorRef): Props = Props(new Receiver(target))
+
+  sealed trait State
+  case object Idle extends State
+  case object Active extends State
+
+  // Java API
+  val idle = Idle
+  val active = Active
+}
+
+import ReliableProxy._
+
+/**
+ * A ReliableProxy is a means to wrap a remote actor reference in order to
+ * obtain certain improved delivery guarantees:
+ *
+ *  - as long as none of the JVMs crashes and the proxy and its remote-deployed
+ *    peer are not forcefully terminated or restarted, no messages will be lost
+ *  - messages re-sent due to the first point will not be delivered out-of-order,
+ *    message ordering is preserved
+ *
+ * These guarantees are valid for the communication between the two end-points
+ * of the reliable “tunnel”, which usually spans an unreliable network. Delivery
+ * from the remote end-point to the target actor is still subject to in-JVM
+ * delivery semantics (i.e. not strictly guaranteed due to possible OutOfMemory
+ * situations or other VM errors).
+ *
+ * You can create a reliable connection like this:
+ * {{{
+ * val proxy = context.actorOf(Props(new ReliableProxy(target)))
+ * }}}
+ * or in Java:
+ * {{{
+ * final ActorRef proxy = getContext().actorOf(new Props(new UntypedActorFactory() {
+ *   public Actor create() {
+ *     return new ReliableProxy(target);
+ *   }
+ * }));
+ * }}}
+ *
+ * '''''Please note:''''' the tunnel is uni-directional, and original sender
+ * information is retained, hence replies by the wrapped target reference will
+ * go back in the normal “unreliable” way unless also secured by a ReliableProxy
+ * from the remote end.
+ *
+ * ==Message Types==
+ *
+ * This actor is an [[akka.actor.FSM]], hence it offers the service of
+ * transition callbacks to those actors which subscribe using the
+ * ``SubscribeTransitionCallBack`` and ``UnsubscribeTransitionCallBack``
+ * messages; see [[akka.actor.FSM]] for more documentation. The proxy will
+ * transition into [[ReliableProxy.Active]] state when ACKs are outstanding and
+ * return to the [[ReliableProxy.Idle]] state when every message send so far
+ * has been confirmed by the peer end-point.
+ * Any other message type sent to this actor will be delivered via a remote-deployed
+ * child actor to the designated target. Message types declared in the companion
+ * object are for internal use only and not to be sent from the outside.
+ *
+ * ==Failure Cases==
+ *
+ * All failures of either the local or the remote end-point are escalated to the
+ * parent of this actor; there are no specific error cases which are predefined.
+ *
+ * ==Arguments==
+ *
+ * '''''target''''' is the [[akka.actor.ActorRef]] to which all messages will be
+ * forwarded which are sent to this actor. It can be any type of actor reference,
+ * but the “remote” tunnel endpoint will be deployed on the node where the target
+ * ref points to.
+ *
+ * '''''retryAfter''''' is the ACK timeout after which all outstanding messages
+ * will be resent. There is not limit on the queue size or the number of retries.
+ */
+class ReliableProxy(target: ActorRef, retryAfter: FiniteDuration) extends Actor with FSM[State, Vector[Message]] {
+
+  val tunnel = context.actorOf(receiver(target).withDeploy(Deploy(scope = RemoteScope(target.path.address))), "tunnel")
+  context.watch(tunnel)
+
+  override def supervisorStrategy = OneForOneStrategy() {
+    case _ ⇒ SupervisorStrategy.Escalate
+  }
+
+  startWith(Idle, Vector.empty)
+
+  when(Idle) {
+    case Event(Terminated(`tunnel`), _) ⇒ stop
+    case Event(Ack(_), _)               ⇒ stay
+    case Event(msg, _)                  ⇒ goto(Active) using Vector(send(msg))
+  }
+
+  onTransition {
+    case Idle -> Active ⇒ scheduleTick()
+    case Active -> Idle ⇒ cancelTimer("resend")
+  }
+
+  when(Active) {
+    case Event(Terminated(`tunnel`), _) ⇒ stop
+    case Event(Ack(serial), queue) ⇒
+      val q = queue dropWhile (m ⇒ compare(m.serial, serial) <= 0)
+      scheduleTick()
+      if (q.isEmpty) goto(Idle) using Vector.empty
+      else stay using q
+    case Event(Tick, queue) ⇒
+      queue foreach (tunnel ! _)
+      scheduleTick()
+      stay
+    case Event(msg, queue) ⇒ stay using (queue :+ send(msg))
+  }
+
+  def scheduleTick(): Unit = setTimer("resend", Tick, retryAfter, false)
+
+  var nextSerial = 1
+  def send(msg: Any): Message = {
+    val m = Message(msg, sender, nextSerial)
+    nextSerial += 1
+    tunnel ! m
+    m
+  }
+
+}
\ No newline at end of file
diff --git a/akka-contrib/src/multi-jvm/scala/akka/contrib/pattern/ReliableProxySpec.scala b/akka-contrib/src/multi-jvm/scala/akka/contrib/pattern/ReliableProxySpec.scala
new file mode 100644
index 0000000000..03fef8da54
--- /dev/null
+++ b/akka-contrib/src/multi-jvm/scala/akka/contrib/pattern/ReliableProxySpec.scala
@@ -0,0 +1,196 @@
+/**
+ *  Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.contrib.pattern
+
+import language.postfixOps
+
+import akka.remote.testkit.MultiNodeConfig
+import akka.remote.testkit.MultiNodeSpec
+import akka.remote.testkit.STMultiNodeSpec
+import org.scalatest.BeforeAndAfterEach
+import akka.remote.testconductor.Direction
+import akka.actor.Props
+import akka.actor.Actor
+import akka.testkit.ImplicitSender
+import scala.concurrent.util.duration._
+import akka.actor.FSM
+import akka.actor.ActorRef
+import akka.testkit.TestProbe
+
+object ReliableProxySpec extends MultiNodeConfig {
+  val local = role("local")
+  val remote = role("remote")
+}
+
+class ReliableProxyMultiJvmNode1 extends ReliableProxySpec
+class ReliableProxyMultiJvmNode2 extends ReliableProxySpec
+
+class ReliableProxySpec extends MultiNodeSpec(ReliableProxySpec) with STMultiNodeSpec with BeforeAndAfterEach with ImplicitSender {
+  import ReliableProxySpec._
+  import ReliableProxy._
+
+  override def initialParticipants = 2
+
+  override def afterEach {
+    runOn(local) {
+      testConductor.throttle(local, remote, Direction.Both, -1).await
+    }
+  }
+
+  runOn(remote) {
+    system.actorOf(Props(new Actor {
+      def receive = {
+        case x ⇒ testActor ! x
+      }
+    }), "echo")
+  }
+
+  val target = system.actorFor(node(remote) / "user" / "echo")
+
+  var proxy: ActorRef = _
+  def expectState(s: State) = expectMsg(FSM.CurrentState(proxy, s))
+  def expectTransition(s1: State, s2: State) = expectMsg(FSM.Transition(proxy, s1, s2))
+
+  runOn(local) {
+    //#demo
+    import akka.contrib.pattern.ReliableProxy
+    
+    proxy = system.actorOf(Props(new ReliableProxy(target, 100.millis)), "proxy")
+    //#demo
+    proxy ! FSM.SubscribeTransitionCallBack(testActor)
+    expectState(Idle)
+    //#demo
+    proxy ! "hello"
+    //#demo
+    expectTransition(Idle, Active)
+    expectTransition(Active, Idle)
+  }
+  runOn(remote) {
+    expectMsg("hello")
+  }
+
+  "A ReliableProxy" must {
+
+    "forward messages in sequence" in {
+      runOn(local) {
+        (1 to 100) foreach (proxy ! _)
+        expectTransition(Idle, Active)
+        expectTransition(Active, Idle)
+      }
+      runOn(remote) {
+        within(1 second) {
+          (1 to 100) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test1a")
+      
+      runOn(local) {
+        (1 to 100) foreach (proxy ! _)
+        expectTransition(Idle, Active)
+        expectTransition(Active, Idle)
+      }
+      runOn(remote) {
+        within(1 second) {
+          (1 to 100) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test1b")
+    }
+
+    "retry when sending fails" in {
+      runOn(local) {
+        testConductor.blackhole(local, remote, Direction.Send).await
+        (1 to 100) foreach (proxy ! _)
+        within(1 second) {
+          expectTransition(Idle, Active)
+          expectNoMsg
+        }
+      }
+      
+      enterBarrier("test2a")
+      
+      runOn(remote) {
+        expectNoMsg(0 seconds)
+      }
+      
+      enterBarrier("test2b")
+      
+      runOn(local) {
+        testConductor.throttle(local, remote, Direction.Send, -1)
+        expectTransition(Active, Idle)
+      }
+      runOn(remote) {
+        within(1 second) {
+          (1 to 100) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test2c")
+    }
+
+    "retry when receiving fails" in {
+      runOn(local) {
+        testConductor.blackhole(local, remote, Direction.Receive).await
+        (1 to 100) foreach (proxy ! _)
+        within(1 second) {
+          expectTransition(Idle, Active)
+          expectNoMsg
+        }
+      }
+      runOn(remote) {
+        within(1 second) {
+          (1 to 100) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test3a")
+      
+      runOn(local) {
+        testConductor.throttle(local, remote, Direction.Receive, -1)
+        expectTransition(Active, Idle)
+      }
+      
+      enterBarrier("test3b")
+    }
+
+    "resend across a slow link" in {
+      runOn(local) {
+        testConductor.throttle(local, remote, Direction.Send, rateMBit = 0.1).await
+        (1 to 50) foreach (proxy ! _)
+        within(5 seconds) {
+          expectTransition(Idle, Active)
+          expectTransition(Active, Idle)
+        }
+      }
+      runOn(remote) {
+        within(5 seconds) {
+          (1 to 50) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test4a")
+      
+      runOn(local) {
+        testConductor.throttle(local, remote, Direction.Send, rateMBit = -1).await
+        testConductor.throttle(local, remote, Direction.Receive, rateMBit = 0.1).await
+        (1 to 50) foreach (proxy ! _)
+        within(5 seconds) {
+          expectTransition(Idle, Active)
+          expectTransition(Active, Idle)
+        }
+      }
+      runOn(remote) {
+        within(1 second) {
+          (1 to 50) foreach { n ⇒ expectMsg(n); lastSender must be === target }
+        }
+      }
+      
+      enterBarrier("test4a")
+    }
+
+  }
+}
\ No newline at end of file
diff --git a/akka-contrib/src/test/java/akka/contrib/pattern/ReliableProxyTest.java b/akka-contrib/src/test/java/akka/contrib/pattern/ReliableProxyTest.java
new file mode 100644
index 0000000000..9522155d81
--- /dev/null
+++ b/akka-contrib/src/test/java/akka/contrib/pattern/ReliableProxyTest.java
@@ -0,0 +1,123 @@
+/**
+ *  Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.contrib.pattern;
+
+import org.junit.AfterClass;
+import org.junit.BeforeClass;
+import org.junit.Test;
+
+import scala.concurrent.util.Duration;
+import scala.concurrent.util.FiniteDuration;
+import akka.actor.Actor;
+import akka.actor.ActorRef;
+import akka.actor.ActorSystem;
+import akka.actor.FSM;
+import akka.actor.Props;
+import akka.actor.UntypedActor;
+import akka.actor.UntypedActorFactory;
+import akka.testkit.TestProbe;
+
+//#import
+import akka.contrib.pattern.ReliableProxy;
+//#import
+
+public class ReliableProxyTest {
+
+  private static ActorSystem system;
+
+  @BeforeClass
+  public static void setup() {
+    system = ActorSystem.create();
+  }
+
+  @AfterClass
+  public static void teardown() {
+    system.shutdown();
+  }
+
+  @Test
+  public void demonstrateUsage() {
+    final TestProbe probe = TestProbe.apply(system);
+    final ActorRef target = probe.ref();
+    final ActorRef parent = system.actorOf(new Props(new UntypedActorFactory() {
+      private static final long serialVersionUID = 1L;
+
+      public Actor create() {
+        return new UntypedActor() {
+
+          //#demo-proxy
+          final ActorRef proxy = getContext().actorOf(
+              new Props(new UntypedActorFactory() {
+                private static final long serialVersionUID = 1L;
+
+                public Actor create() {
+                  final FiniteDuration retry = Duration.create(100, "millis");
+                  return new ReliableProxy(target, retry);
+                }
+              }));
+
+          public void onReceive(Object msg) {
+            if ("hello".equals(msg)) {
+              proxy.tell("world!", getSelf());
+            }
+          }
+          //#demo-proxy
+        };
+      }
+    }));
+    parent.tell("hello", null);
+    probe.expectMsg("world!");
+  }
+  
+  @Test
+  public void demonstrateTransitions() {
+    final ActorRef target = system.deadLetters();
+    final ActorRef parent = system.actorOf(new Props(new UntypedActorFactory() {
+      private static final long serialVersionUID = 1L;
+
+      public Actor create() {
+        return new UntypedActor() {
+
+          //#demo-transition
+          final ActorRef proxy = getContext().actorOf(
+              new Props(new UntypedActorFactory() {
+                private static final long serialVersionUID = 1L;
+
+                public Actor create() {
+                  final FiniteDuration retry = Duration.create(100, "millis");
+                  return new ReliableProxy(target, retry);
+                }
+              }));
+          ActorRef client = null;
+          
+          {
+            proxy.tell(new FSM.SubscribeTransitionCallBack(getSelf()), getSelf());
+          }
+
+          public void onReceive(Object msg) {
+            if ("hello".equals(msg)) {
+              proxy.tell("world!", getSelf());
+              client = getSender();
+            } else if (msg instanceof FSM.CurrentState<?>) {
+              // get initial state
+            } else if (msg instanceof FSM.Transition<?>) {
+              @SuppressWarnings("unchecked")
+              final FSM.Transition<ReliableProxy.State> transition =
+                  (FSM.Transition<ReliableProxy.State>) msg;
+              assert transition.fsmRef().equals(proxy);
+              if (transition.to().equals(ReliableProxy.idle())) {
+                client.tell("done", getSelf());
+              }
+            }
+          }
+          //#demo-transition
+        };
+      }
+    }));
+    final TestProbe probe = TestProbe.apply(system);
+    parent.tell("hello", probe.ref());
+    probe.expectMsg("done");
+  }
+}
diff --git a/akka-contrib/src/test/scala/akka/contrib/pattern/ReliableProxyDocSpec.scala b/akka-contrib/src/test/scala/akka/contrib/pattern/ReliableProxyDocSpec.scala
new file mode 100644
index 0000000000..1e89cb8a05
--- /dev/null
+++ b/akka-contrib/src/test/scala/akka/contrib/pattern/ReliableProxyDocSpec.scala
@@ -0,0 +1,41 @@
+/**
+ *  Copyright (C) 2009-2012 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package akka.contrib.pattern
+
+import akka.testkit.AkkaSpec
+import akka.actor.Props
+import akka.actor.Actor
+import akka.testkit.ImplicitSender
+import scala.concurrent.util.duration._
+import akka.actor.FSM
+import akka.actor.ActorRef
+
+class ReliableProxyDocSpec extends AkkaSpec with ImplicitSender {
+
+  "A ReliableProxy" must {
+
+    "show state transitions" in {
+      val target = system.deadLetters
+      val a = system.actorOf(Props(new Actor {
+        //#demo-transition
+        val proxy = context.actorOf(Props(new ReliableProxy(target, 100.millis)))
+        proxy ! FSM.SubscribeTransitionCallBack(self)
+
+        var client: ActorRef = _
+
+        def receive = {
+          case "go"                               ⇒ proxy ! 42; client = sender
+          case FSM.CurrentState(`proxy`, initial) ⇒
+          case FSM.Transition(`proxy`, from, to)  ⇒ if (to == ReliableProxy.Idle) client ! "done"
+        }
+        //#demo-transition
+      }))
+      a ! "go"
+      expectMsg("done")
+    }
+
+  }
+
+}
\ No newline at end of file
diff --git a/akka-docs/rst/experimental/index.rst b/akka-docs/rst/experimental/index.rst
index 5b3b1465ee..47339a8fb0 100644
--- a/akka-docs/rst/experimental/index.rst
+++ b/akka-docs/rst/experimental/index.rst
@@ -16,12 +16,18 @@ in minor releases without notice as we refine and simplify based on your
 feedback. An experimental module may be dropped in major releases without 
 prior deprecation.
 
-Another reason for marking a module as experimental is that it's too early
-to tell if the module has a maintainer that can take the responsibility
-of the module over time.
-
 .. toctree::
    :maxdepth: 1
 
    ../cluster/index
    ../dev/multi-node-testing
+
+Another reason for marking a module as experimental is that it's too early
+to tell if the module has a maintainer that can take the responsibility
+of the module over time. These modules live in the ``akka-contrib`` subproject:
+
+.. toctree::
+   :maxdepth: 2
+
+   ../b/../../../akka-contrib/docs/index.rst
+
diff --git a/project/AkkaBuild.scala b/project/AkkaBuild.scala
index a0881ef6ed..5a0506b6f0 100644
--- a/project/AkkaBuild.scala
+++ b/project/AkkaBuild.scala
@@ -135,7 +135,7 @@ object AkkaBuild extends Build {
     id = "akka-remote-tests-experimental",
     base = file("akka-remote-tests"),
     dependencies = Seq(remote, actorTests % "test->test", testkit),
-    settings = defaultSettings ++ multiJvmSettings ++ Seq(
+    settings = defaultSettings ++ multiJvmSettings ++ experimentalSettings ++ Seq(
       libraryDependencies ++= Dependencies.remoteTests,
       // disable parallel tests
       parallelExecution in Test := false,
@@ -143,19 +143,7 @@ object AkkaBuild extends Build {
         (name: String) => (src ** (name + ".conf")).get.headOption.map("-Dakka.config=" + _.absolutePath).toSeq
       },
       scalatestOptions in MultiJvm := defaultMultiJvmScalatestOptions,
-      jvmOptions in MultiJvm := defaultMultiJvmOptions,
-      previousArtifact := akkaPreviousArtifact("akka-remote"),
-      description := """|This module of Akka is marked as
-                        |experimental, which means that it is in early
-                        |access mode, which also means that it is not covered
-                        |by commercial support. An experimental module doesn't
-                        |have to obey the rule of staying binary compatible
-                        |between minor releases. Breaking API changes may be
-                        |introduced in minor releases without notice as we
-                        |refine and simplify based on your feedback. An
-                        |experimental module may be dropped in major releases
-                        |without prior deprecation.
-                        |""".stripMargin
+      previousArtifact := akkaPreviousArtifact("akka-remote")
     )
   ) configs (MultiJvm)
 
@@ -163,7 +151,7 @@ object AkkaBuild extends Build {
     id = "akka-cluster-experimental",
     base = file("akka-cluster"),
     dependencies = Seq(remote, remoteTests % "test->test" , testkit % "test->test"),
-    settings = defaultSettings ++ multiJvmSettings ++ OSGi.cluster ++ Seq(
+    settings = defaultSettings ++ multiJvmSettings ++ OSGi.cluster ++ experimentalSettings ++ Seq(
       libraryDependencies ++= Dependencies.cluster,
       // disable parallel tests
       parallelExecution in Test := false,
@@ -171,19 +159,7 @@ object AkkaBuild extends Build {
         (name: String) => (src ** (name + ".conf")).get.headOption.map("-Dakka.config=" + _.absolutePath).toSeq
       },
       scalatestOptions in MultiJvm := defaultMultiJvmScalatestOptions,
-      jvmOptions in MultiJvm := defaultMultiJvmOptions,
-      previousArtifact := akkaPreviousArtifact("akka-remote"),
-      description := """|This module of Akka is marked as
-                        |experimental, which means that it is in early
-                        |access mode, which also means that it is not covered
-                        |by commercial support. An experimental module doesn't
-                        |have to obey the rule of staying binary compatible
-                        |between minor releases. Breaking API changes may be
-                        |introduced in minor releases without notice as we
-                        |refine and simplify based on your feedback. An
-                        |experimental module may be dropped in major releases
-                        |without prior deprecation.
-                        |""".stripMargin
+      previousArtifact := akkaPreviousArtifact("akka-remote")
     )
   ) configs (MultiJvm)
 
@@ -354,25 +330,13 @@ object AkkaBuild extends Build {
     id = "akka-sample-cluster-experimental",
     base = file("akka-samples/akka-sample-cluster"),
     dependencies = Seq(cluster, remoteTests % "test", testkit % "test"),
-    settings = sampleSettings ++ multiJvmSettings ++ Seq(
+    settings = sampleSettings ++ multiJvmSettings ++ experimentalSettings ++ Seq(
       libraryDependencies ++= Dependencies.clusterSample,
       // disable parallel tests
       parallelExecution in Test := false,
       extraOptions in MultiJvm <<= (sourceDirectory in MultiJvm) { src =>
         (name: String) => (src ** (name + ".conf")).get.headOption.map("-Dakka.config=" + _.absolutePath).toSeq
-      },
-      jvmOptions in MultiJvm := defaultMultiJvmOptions,
-      description := """|This module of Akka is marked as
-                        |experimental, which means that it is in early
-                        |access mode, which also means that it is not covered
-                        |by commercial support. An experimental module doesn't
-                        |have to obey the rule of staying binary compatible
-                        |between minor releases. Breaking API changes may be
-                        |introduced in minor releases without notice as we
-                        |refine and simplify based on your feedback. An
-                        |experimental module may be dropped in major releases
-                        |without prior deprecation.
-                        |""".stripMargin
+      }
     )
   ) configs (MultiJvm)
 
@@ -380,14 +344,13 @@ object AkkaBuild extends Build {
     id = "akka-sample-multi-node-experimental",
     base = file("akka-samples/akka-sample-multi-node"),
     dependencies = Seq(remoteTests % "test", testkit % "test"),
-    settings = sampleSettings ++ multiJvmSettings ++ Seq(
+    settings = sampleSettings ++ multiJvmSettings ++ experimentalSettings ++ Seq(
       libraryDependencies ++= Dependencies.multiNodeSample,
       // disable parallel tests
       parallelExecution in Test := false,
       extraOptions in MultiJvm <<= (sourceDirectory in MultiJvm) { src =>
         (name: String) => (src ** (name + ".conf")).get.headOption.map("-Dakka.config=" + _.absolutePath).toSeq
-      },
-      jvmOptions in MultiJvm := defaultMultiJvmOptions
+      }
     )
   ) configs (MultiJvm)
 
@@ -408,8 +371,10 @@ object AkkaBuild extends Build {
   lazy val contrib = Project(
     id = "akka-contrib",
     base = file("akka-contrib"),
-    dependencies = Seq(actor),
-    settings = defaultSettings ++ Seq(
+    dependencies = Seq(remote, remoteTests % "compile;test->test"),
+    settings = defaultSettings ++ multiJvmSettings ++ Seq(
+      libraryDependencies ++= Dependencies.contrib,
+      testOptions += Tests.Argument(TestFrameworks.JUnit, "-v"),
       description := """|
                         |This subproject provides a home to modules contributed by external
                         |developers which may or may not move into the officially supported code
@@ -421,7 +386,7 @@ object AkkaBuild extends Build {
                         |support for these modules.
                         |""".stripMargin
     )
-  )
+  ) configs (MultiJvm)
 
   // Settings
 
@@ -448,6 +413,20 @@ object AkkaBuild extends Build {
     publishArtifact in Compile := false
   )
 
+  lazy val experimentalSettings = Seq(
+    description := """|This module of Akka is marked as
+                      |experimental, which means that it is in early
+                      |access mode, which also means that it is not covered
+                      |by commercial support. An experimental module doesn't
+                      |have to obey the rule of staying binary compatible
+                      |between minor releases. Breaking API changes may be
+                      |introduced in minor releases without notice as we
+                      |refine and simplify based on your feedback. An
+                      |experimental module may be dropped in major releases
+                      |without prior deprecation.
+                      |""".stripMargin
+  )
+
   val excludeTestNames = SettingKey[Seq[String]]("exclude-test-names")
   val excludeTestTags = SettingKey[Set[String]]("exclude-test-tags")
   val includeTestTags = SettingKey[Set[String]]("include-test-tags")
@@ -589,6 +568,7 @@ object AkkaBuild extends Build {
   }
 
   lazy val multiJvmSettings = SbtMultiJvm.multiJvmSettings ++ inConfig(MultiJvm)(ScalariformPlugin.scalariformSettings) ++ Seq(
+    jvmOptions in MultiJvm := defaultMultiJvmOptions,
     compileInputs in MultiJvm <<= (compileInputs in MultiJvm) dependsOn (ScalariformKeys.format in MultiJvm),
     compile in MultiJvm <<= (compile in MultiJvm) triggeredBy (compile in Test),
     ScalariformKeys.preferences in MultiJvm := formattingPreferences) ++
@@ -706,6 +686,8 @@ object Dependencies {
 
   val clusterSample = Seq(Test.scalatest)
 
+  val contrib = Seq(Test.junitIntf)
+
   val multiNodeSample = Seq(Test.scalatest)
 }