diff --git a/akka-docs/rst/java/mailboxes.rst b/akka-docs/rst/java/mailboxes.rst index d51747dede..ea145b1f72 100644 --- a/akka-docs/rst/java/mailboxes.rst +++ b/akka-docs/rst/java/mailboxes.rst @@ -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`` ======================================= diff --git a/akka-docs/rst/scala/mailboxes.rst b/akka-docs/rst/scala/mailboxes.rst index cef00ad0fc..e679dda3ad 100644 --- a/akka-docs/rst/scala/mailboxes.rst +++ b/akka-docs/rst/scala/mailboxes.rst @@ -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 -------------------------------------------------