com.lightbend.lagom.internal.scaladsl.persistence
A stream of the persistent events that have the given aggregateTag
, e.g.
A stream of the persistent events that have the given aggregateTag
, e.g.
all persistent events of all Order
entities.
The type of the offset is journal dependent, some journals use time-based
UUID offsets, while others use sequence numbers. The passed in fromOffset
must either be akka.persistence.query.NoOffset, or an offset that has previously been produced
by this journal.
The stream will begin with events starting after fromOffset
.
To resume an event stream, store the Offset
corresponding to the most
recently processed Event
, and pass that back as the value for
fromOffset
to start the stream from events following that one.
IllegalArgumentException
If the fromOffset
type is not supported
by this journal.
The events by tag query.
The events by tag query. Necessary for implementing read sides and the eventStream query.
Gracefully stop the persistent entities and leave the cluster.
Gracefully stop the persistent entities and leave the cluster. The persistent entities will be started on another node when new messages are sent to them.
the Future
is completed when the node has been
removed from the cluster
Converts a stored event journal offset into the argument to an
eventsByTag
query.
Converts a stored event journal offset into the argument to an
eventsByTag
query.
Different Akka Persistence back ends interpret the offset
parameter to
eventsByTag
differently. Some return events starting after the given
offset
, others start with the event at that offset. In Lagom, we
shield end users from this difference, and always want to return
unprocessed events. Subclasses can override this method as necessary to
convert a stored offset into a starting offset that ensures no stored
values will be repeated in the stream.
the most recently seen offset
an offset that can be provided to the eventsByTag
query to
retrieve only unseen events
Retrieve a com.lightbend.lagom.scaladsl.persistence.PersistentEntityRef for a given com.lightbend.lagom.scaladsl.persistence.PersistentEntity class and identifier.
Retrieve a com.lightbend.lagom.scaladsl.persistence.PersistentEntityRef for a
given com.lightbend.lagom.scaladsl.persistence.PersistentEntity class
and identifier. Commands are sent to a PersistentEntity
using a PersistentEntityRef
.
At system startup all com.lightbend.lagom.scaladsl.persistence.PersistentEntity classes must be registered with this method.
At system startup all com.lightbend.lagom.scaladsl.persistence.PersistentEntity classes must be registered with this method.
The entityFactory
will be called when a new entity instance is to be created.
That will happen in another thread, so the entityFactory
must be thread-safe, e.g.
not close over shared mutable state that is not thread-safe.
Provides shared functionality for implementing a persistent entity registry.
Akka persistence plugins can extend this to implement a custom registry.