Merge remote-tracking branch 'origin/master' into wip-1581-patterns-ask

akka-docs/scala/code/akka/docs/routing/ActorPoolExample.scala

@@ -1,24 +0,0 @@
-/**
- * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
- */
-package akka.docs.routing
-
-import akka.routing.{ BasicNoBackoffFilter, SmallestMailboxSelector, DefaultActorPool }
-import akka.actor.{ ActorRef, Props, Actor }
-
-//#testPool
-class TestPool extends Actor with DefaultActorPool with SmallestMailboxSelector with BasicNoBackoffFilter {
-
-  def capacity(delegates: Seq[ActorRef]) = 5
-  protected def receive = _route
-  def rampupRate = 0.1
-  def selectionCount = 1
-  def partialFill = true
-
-  def instance(defaults: Props) = context.actorOf(defaults.withCreator(new Actor {
-    def receive = {
-      case _ ⇒ // do something
-    }
-  }))
-}
-//#testPool

akka-docs/scala/code/akka/docs/routing/BoundedCapacitorExample.scala

@@ -1,26 +0,0 @@
-/**
- * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
- */
-package akka.docs.routing
-
-import akka.actor.ActorRef
-
-//#boundedCapacitor
-trait BoundedCapacitor {
-  def lowerBound: Int
-  def upperBound: Int
-
-  def capacity(delegates: Seq[ActorRef]): Int = {
-    val current = delegates length
-    var delta = _eval(delegates)
-    val proposed = current + delta
-
-    if (proposed < lowerBound) delta += (lowerBound - proposed)
-    else if (proposed > upperBound) delta -= (proposed - upperBound)
-
-    delta
-  }
-
-  protected def _eval(delegates: Seq[ActorRef]): Int
-}
-//#boundedCapacitor

akka-docs/scala/code/akka/docs/routing/CapacityStrategyExample.scala

@@ -1,19 +0,0 @@
-/**
- * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
- */
-package akka.docs.routing
-
-import akka.routing.ActorPool
-import akka.actor.ActorRef
-
-//#capacityStrategy
-trait CapacityStrategy {
-  import ActorPool._
-
-  def pressure(delegates: Seq[ActorRef]): Int
-  def filter(pressure: Int, capacity: Int): Int
-
-  protected def _eval(delegates: Seq[ActorRef]): Int =
-    filter(pressure(delegates), delegates.size)
-}
-//#capacityStrategy

akka-docs/scala/code/akka/docs/routing/RouterTypeExample.scala

@@ -9,6 +9,7 @@ import akka.actor.{ Props, Actor }
 import akka.util.duration._
 import akka.dispatch.Await
 import akka.pattern.ask
+import akka.routing.SmallestMailboxRouter
 
 case class FibonacciNumber(nbr: Int)
 
@@ -47,7 +48,7 @@ class ParentActor extends Actor {
     case "rrr" ⇒
       //#roundRobinRouter
       val roundRobinRouter =
-        context.actorOf(Props[PrintlnActor].withRouter(RoundRobinRouter()), "router")
+        context.actorOf(Props[PrintlnActor].withRouter(RoundRobinRouter(5)), "router")
       1 to 10 foreach {
         i ⇒ roundRobinRouter ! i
       }
@@ -55,22 +56,30 @@ class ParentActor extends Actor {
     case "rr" ⇒
       //#randomRouter
       val randomRouter =
-        context.actorOf(Props[PrintlnActor].withRouter(RandomRouter()), "router")
+        context.actorOf(Props[PrintlnActor].withRouter(RandomRouter(5)), "router")
       1 to 10 foreach {
         i ⇒ randomRouter ! i
       }
     //#randomRouter
+    case "smr" ⇒
+      //#smallestMailboxRouter
+      val smallestMailboxRouter =
+        context.actorOf(Props[PrintlnActor].withRouter(SmallestMailboxRouter(5)), "router")
+      1 to 10 foreach {
+        i ⇒ smallestMailboxRouter ! i
+      }
+    //#smallestMailboxRouter
     case "br" ⇒
       //#broadcastRouter
       val broadcastRouter =
-        context.actorOf(Props[PrintlnActor].withRouter(BroadcastRouter()), "router")
+        context.actorOf(Props[PrintlnActor].withRouter(BroadcastRouter(5)), "router")
       broadcastRouter ! "this is a broadcast message"
     //#broadcastRouter
     case "sgfcr" ⇒
       //#scatterGatherFirstCompletedRouter
       val scatterGatherFirstCompletedRouter = context.actorOf(
-        Props[FibonacciActor].withRouter(ScatterGatherFirstCompletedRouter(within = 2 seconds)),
-        "router")
+        Props[FibonacciActor].withRouter(ScatterGatherFirstCompletedRouter(
+          nrOfInstances = 5, within = 2 seconds)), "router")
       implicit val timeout = context.system.settings.ActorTimeout
       val futureResult = scatterGatherFirstCompletedRouter ? FibonacciNumber(10)
       val result = Await.result(futureResult, timeout.duration)

akka-docs/scala/code/akka/docs/routing/RouterViaConfigExample.scala

@@ -4,7 +4,8 @@
 package akka.docs.routing
 
 import akka.actor.{ Actor, Props, ActorSystem }
-import akka.routing.RoundRobinRouter
+import com.typesafe.config.ConfigFactory
+import akka.routing.FromConfig
 
 case class Message(nbr: Int)
 
@@ -15,10 +16,37 @@ class ExampleActor extends Actor {
 }
 
 object RouterWithConfigExample extends App {
-  val system = ActorSystem("Example")
+  val config = ConfigFactory.parseString("""
+    //#config
+    akka.actor.deployment {
+      /router {
+        router = round-robin
+        nr-of-instances = 5
+      }
+    }
+    //#config
+    //#config-resize
+    akka.actor.deployment {
+      /router2 {
+        router = round-robin
+        resizer {
+          lower-bound = 2
+          upper-bound = 15
+        }
+      }
+    }
+    //#config-resize
+      """)
+  val system = ActorSystem("Example", config)
   //#configurableRouting
-  val router = system.actorOf(Props[PrintlnActor].withRouter(RoundRobinRouter()),
-    "exampleActor")
+  val router = system.actorOf(Props[ExampleActor].withRouter(FromConfig()),
+    "router")
   //#configurableRouting
   1 to 10 foreach { i ⇒ router ! Message(i) }
+
+  //#configurableRoutingWithResizer
+  val router2 = system.actorOf(Props[ExampleActor].withRouter(FromConfig()),
+    "router2")
+  //#configurableRoutingWithResizer
+  1 to 10 foreach { i ⇒ router2 ! Message(i) }
 }

akka-docs/scala/code/akka/docs/routing/RouterViaProgramExample.scala

@@ -5,6 +5,7 @@ package akka.docs.routing
 
 import akka.routing.RoundRobinRouter
 import akka.actor.{ ActorRef, Props, Actor, ActorSystem }
+import akka.routing.DefaultResizer
 
 case class Message1(nbr: Int)
 
@@ -31,4 +32,12 @@ object RoutingProgrammaticallyExample extends App {
     RoundRobinRouter(routees = routees)))
   //#programmaticRoutingRoutees
   1 to 6 foreach { i ⇒ router2 ! Message1(i) }
+
+  //#programmaticRoutingWithResizer
+  val resizer = DefaultResizer(lowerBound = 2, upperBound = 15)
+  val router3 = system.actorOf(Props[ExampleActor1].withRouter(
+    RoundRobinRouter(resizer = Some(resizer))))
+  //#programmaticRoutingWithResizer
+  1 to 6 foreach { i ⇒ router3 ! Message1(i) }
+
 }