Merge pull request #1595 from akka/wip-3483-default-mailbox-patriknw

DOC: how to change default mailbox, see #3483
This commit is contained in:
Roland Kuhn 2013-07-08 02:46:11 -07:00
commit 9fb76eb251
2 changed files with 32 additions and 1 deletions

View file

@ -79,6 +79,22 @@ dispatcher which will execute it. Then the mailbox is determined as follows:
6. The default mailbox ``akka.actor.default-mailbox`` will be used.
Default Mailbox
---------------
When the mailbox is not specified as described above the default mailbox
is used. By default it is an unbounded mailbox, which is backed by a
``java.util.concurrent.ConcurrentLinkedQueue``.
``SingleConsumerOnlyUnboundedMailbox`` is an even more efficient mailbox, and
it can be used as the default mailbox, but it cannot be used with a BalancingDispatcher.
Configuration of ``SingleConsumerOnlyUnboundedMailbox`` as default mailbox::
akka.actor.default-mailbox {
mailbox-type = "akka.dispatch.SingleConsumerOnlyUnboundedMailbox"
}
Which Configuration is passed to the Mailbox Type
-------------------------------------------------
@ -198,7 +214,6 @@ configuration, or the mailbox configuration.
this mailbox type; the mailbox type will be instantiated once for each
dispatcher or mailbox setting using it.
Special Semantics of ``system.actorOf``
=======================================