raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

Merge pull request #17644 from ktoso/wip-docs-better-balancing-dispatcher-ktoso

Browse source 
+doc #17597 improve BalancingPool docs, show configuring executor
This commit is contained in:
Konrad Malawski 2015-07-03 16:31:26 +02:00
commit bae00cefc1
3 changed files with 57 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

13
akka-docs/rst/java/routing.rst
View file

@ -279,6 +279,19 @@ configuration.
.. includecode:: ../scala/code/docs/routing/RouterDocSpec.scala#config-balancing-pool2
The ``BalancingPool`` automatically uses a special ``BalancingDispatcher`` for its
routees - disregarding any dispatcher that is set on the the routee Props object.
This is needed in order to implement the balancing semantics via
sharing the same mailbox by all the routees.
While it is not possible to change the dispatcher used by the routees, it is possible
to fine tune the used *executor*. By default the ``fork-join-dispatcher`` is used and
can be configured as explained in :ref:`dispatchers-java`. In situations where the
routees are expected to perform blocking operations it may be useful to replace it
with a ``thread-pool-executor`` hinting the number of allocated threads explicitly:
.. includecode:: ../scala/code/docs/routing/RouterDocSpec.scala#config-balancing-pool3
There is no Group variant of the BalancingPool.
SmallestMailboxPool