diff --git a/akka-docs/rst/java/mailboxes.rst b/akka-docs/rst/java/mailboxes.rst index ea6f4b4eb6..85fe13f502 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 ------------------------------------------------- @@ -179,7 +195,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 ccd1c6076d..3af6543551 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 -------------------------------------------------