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

=doc #18636 Correction of mailbox documentation

Browse source
This commit is contained in:
Patrik Nordwall 2015-10-09 14:51:32 +02:00
parent aad2c4ca35
commit 49492cdfa6
2 changed files with 67 additions and 62 deletions
Download patch file Download diff file Expand all files Collapse all files

61
akka-docs/rst/scala/mailboxes.rst
View file

@ -153,30 +153,45 @@ Akka comes shipped with a number of mailbox implementations:
- Bounded: No
- Configuration name: "akka.dispatch.UnboundedControlAwareMailbox"
Previously available mailbox implementations which were deprecated because they might block:
* **BoundedMailbox**
- Backed by a ``java.util.concurrent.LinkedBlockingQueue``
- Blocking: Yes
- Bounded: Yes
- Configuration name: "bounded" or "akka.dispatch.BoundedMailbox"
* **UnboundedPriorityMailbox**
- Backed by a ``java.util.concurrent.PriorityBlockingQueue``
- Delivery order for messages of equal priority is undefined - contrast with the UnboundedStablePriorityMailbox
- Blocking: Yes
- Blocking: No
- Bounded: No
- Configuration name: "akka.dispatch.UnboundedPriorityMailbox"
* **UnboundedStablePriorityMailbox**
- Backed by a ``java.util.concurrent.PriorityBlockingQueue`` wrapped in an ``akka.util.PriorityQueueStabilizer``
- FIFO order is preserved for messages of equal priority - contrast with the UnboundedPriorityMailbox
- Blocking: No
- Bounded: No
- Configuration name: "akka.dispatch.UnboundedStablePriorityMailbox"
Other bounded mailbox implementations which will block the sender if the capacity is reached and
configured with non-zero ``mailbox-push-timeout-time``.
.. note:: The following mailboxes should only be used with zero ``mailbox-push-timeout-time``.
* **BoundedMailbox**
- Backed by a ``java.util.concurrent.LinkedBlockingQueue``
- Blocking: Yes if used with non-zero ``mailbox-push-timeout-time``, otherwise No
- Bounded: Yes
- Configuration name: "bounded" or "akka.dispatch.BoundedMailbox"
* **BoundedPriorityMailbox**
@ -184,31 +199,19 @@ Previously available mailbox implementations which were deprecated because they
- Delivery order for messages of equal priority is undefined - contrast with the ``BoundedStablePriorityMailbox``
- Blocking: Yes
- Blocking: Yes if used with non-zero ``mailbox-push-timeout-time``, otherwise No
- Bounded: Yes
- Configuration name: ``"akka.dispatch.BoundedPriorityMailbox"``
* **UnboundedStablePriorityMailbox**
- Backed by a ``java.util.concurrent.PriorityBlockingQueue`` wrapped in an ``akka.util.PriorityQueueStabilizer``
- FIFO order is preserved for messages of equal priority - contrast with the UnboundedPriorityMailbox
- Blocking: Yes
- Bounded: No
- Configuration name: "akka.dispatch.UnboundedStablePriorityMailbox"
* **BoundedStablePriorityMailbox**
- Backed by a ``java.util.PriorityQueue`` wrapped in an ``akka.util.PriorityQueueStabilizer`` and an ``akka.util.BoundedBlockingQueue``
- FIFO order is preserved for messages of equal priority - contrast with the BoundedPriorityMailbox
- Blocking: Yes
- Blocking: Yes if used with non-zero ``mailbox-push-timeout-time``, otherwise No
- Bounded: Yes
@ -220,7 +223,7 @@ Previously available mailbox implementations which were deprecated because they
- Backed by two ``java.util.concurrent.ConcurrentLinkedQueue`` and blocking on enqueue if capacity has been reached
- Blocking: Yes
- Blocking: Yes if used with non-zero ``mailbox-push-timeout-time``, otherwise No
- Bounded: Yes