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

Incorporate review feedback. See #2061

Browse source
This commit is contained in:
Patrik Nordwall 2012-05-21 07:46:48 +02:00
parent 8924080017
commit 1e82a231c9
2 changed files with 11 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
akka-docs/modules/code/akka/docs/actor/mailbox/DurableMailboxDocSpec.scala
View file

@ -73,13 +73,19 @@ class MyMessageQueue(_owner: ActorContext)
def dequeue(): Envelope = { def dequeue(): Envelope = {
val data: Option[Array[Byte]] = storage.pull() val data: Option[Array[Byte]] = storage.pull()
data.map(deserialize(_)).getOrElse(null) data.map(deserialize).orNull
} }
def hasMessages: Boolean = !storage.isEmpty def hasMessages: Boolean = !storage.isEmpty
def numberOfMessages: Int = storage.size def numberOfMessages: Int = storage.size
/**
* Called when the mailbox is disposed.
* An ordinary mailbox would send remaining messages to deadLetters,
* but the purpose of a durable mailbox is to continue
* with the same message queue when the actor is started again.
*/
def cleanUp(owner: ActorContext, deadLetters: MessageQueue): Unit = () def cleanUp(owner: ActorContext, deadLetters: MessageQueue): Unit = ()
} }

7
akka-docs/modules/durable-mailbox.rst
View file

@ -9,7 +9,7 @@
Overview Overview
======== ========
A durable mailbox is a replacement for the standard actor mailbox that is durable. A durable mailbox is a mailbox which stores the messages on durable storage.
What this means in practice is that if there are pending messages in the actor's What this means in practice is that if there are pending messages in the actor's
mailbox when the node of the actor resides on crashes, then when you restart the mailbox when the node of the actor resides on crashes, then when you restart the
node, the actor will be able to continue processing as if nothing had happened; node, the actor will be able to continue processing as if nothing had happened;
@ -29,7 +29,7 @@ Open Source projects, such as:
* `AMQP Durable Mailbox <https://github.com/drexin/akka-amqp-mailbox>`_ * `AMQP Durable Mailbox <https://github.com/drexin/akka-amqp-mailbox>`_
A durable mailbox typically doesn't implements transactions for current message. It's possible A durable mailbox is like any other mailbox not likely to be transactional. It's possible
if the actor crashes after receiving a message, but before completing processing of if the actor crashes after receiving a message, but before completing processing of
it, that the message could be lost. it, that the message could be lost.
@ -98,4 +98,5 @@ Add this dependency::
"com.typesafe.akka" % "akka-mailboxes-common-test" % "2.1-SNAPSHOT" "com.typesafe.akka" % "akka-mailboxes-common-test" % "2.1-SNAPSHOT"
For more inspiration you can look at the old implementations based on Redis, MongoDB, Beanstalk, For more inspiration you can look at the old implementations based on Redis, MongoDB, Beanstalk,
and ZooKeeper, which can be found in Akka git repository tag v2.0.1. and ZooKeeper, which can be found in Akka git repository tag
`v2.0.1 <https://github.com/akka/akka/tree/v2.0.1/akka-durable-mailboxes>`_.