improve documentation of explicitly given routees

This commit is contained in:
Roland 2012-05-22 13:07:05 +02:00
parent 916c2d4d11
commit 9ac11a6432
5 changed files with 16 additions and 6 deletions

View file

@ -55,7 +55,7 @@ public class RouterViaProgramExample {
ActorRef actor2 = system.actorOf(new Props(ExampleActor.class));
ActorRef actor3 = system.actorOf(new Props(ExampleActor.class));
Iterable<ActorRef> routees = Arrays.asList(new ActorRef[] { actor1, actor2, actor3 });
ActorRef router2 = system.actorOf(new Props(ExampleActor.class).withRouter(RoundRobinRouter.create(routees)));
ActorRef router2 = system.actorOf(new Props().withRouter(RoundRobinRouter.create(routees)));
//#programmaticRoutingRoutees
for (int i = 1; i <= 6; i++) {
router2.tell(new ExampleActor.Message(i));

View file

@ -33,6 +33,11 @@ You can also give the router already created routees as in:
.. includecode:: code/akka/docs/jrouting/RouterViaProgramExample.java#programmaticRoutingRoutees
It should be noted that no actor factory or class needs to be provided in this
case, as the ``Router`` will not create any children on its own (which is not
true anymore when using a resizer). The routees can also be specified by giving
their path strings.
When you create a router programmatically you define the number of routees *or* you pass already created routees to it.
If you send both parameters to the router *only* the latter will be used, i.e. ``nrOfInstances`` is disregarded.
@ -48,7 +53,7 @@ Once you have the router actor it is just to send messages to it as you would to
router.tell(new MyMsg());
The router will apply its behavior to the message it receives and forward it to the routees.
The router will forward the message to its routees according to its routing policy.
Remotely Deploying Routees
**************************