Package akka.persistence.testkit.state.scaladsl

Class PersistenceTestKitDurableStateStore<A>

java.lang.Object

akka.persistence.testkit.state.scaladsl.PersistenceTestKitDurableStateStore<A>

All Implemented Interfaces:

DurableStateStorePagedPersistenceIdsQuery<A>, DurableStateStoreQuery<A>, ReadJournal, CurrentEventsBySliceQuery, DurableStateStoreBySliceQuery<A>, EventsBySliceQuery, DurableStateStore<A>, DurableStateUpdateStore<A>, DurableStateUpdateWithChangeEventStore<A>

public class PersistenceTestKitDurableStateStore<A>
extends java.lang.Object
implements DurableStateUpdateWithChangeEventStore<A>, DurableStateStoreQuery<A>, DurableStateStoreBySliceQuery<A>, DurableStateStorePagedPersistenceIdsQuery<A>, CurrentEventsBySliceQuery, EventsBySliceQuery

Constructor Summary

Constructors

Constructor	Description
PersistenceTestKitDurableStateStore(ExtendedActorSystem system)

Method Summary

Modifier and Type	Method	Description
Source<DurableStateChange<A>,NotUsed>	changes(java.lang.String tag, Offset offset)	Get a source of the most recent changes made to objects of the given tag since the passed in offset.
Source<DurableStateChange<A>,NotUsed>	changesBySlices(java.lang.String entityType, int minSlice, int maxSlice, Offset offset)	Get a source of the most recent changes made to objects of the given slice range since the passed in offset.
Source<DurableStateChange<A>,NotUsed>	currentChanges(java.lang.String tag, Offset offset)	Get a source of the most recent changes made to objects with the given tag since the passed in offset.
Source<DurableStateChange<A>,NotUsed>	currentChangesBySlices(java.lang.String entityType, int minSlice, int maxSlice, Offset offset)	Get a source of the most recent changes made to objects with the given slice range since the passed in offset.
<Event> Source<EventEnvelope<Event>,NotUsed>	currentEventsBySlices(java.lang.String entityType, int minSlice, int maxSlice, Offset offset)	For change events.
Source<java.lang.String,NotUsed>	currentPersistenceIds(scala.Option<java.lang.String> afterId, long limit)	Get the current persistence ids.
scala.concurrent.Future<Done>	deleteObject(java.lang.String persistenceId)
scala.concurrent.Future<Done>	deleteObject(java.lang.String persistenceId, long revision)
scala.concurrent.Future<Done>	deleteObject(java.lang.String persistenceId, long revision, java.lang.Object changeEvent)
<Event> Source<EventEnvelope<Event>,NotUsed>	eventsBySlices(java.lang.String entityType, int minSlice, int maxSlice, Offset offset)	For change events.
scala.concurrent.Future<GetObjectResult<A>>	getObject(java.lang.String persistenceId)
static java.lang.String	Identifier()
int	sliceForPersistenceId(java.lang.String persistenceId)
scala.collection.immutable.Seq<scala.collection.immutable.Range>	sliceRanges(int numberOfRanges)
ExtendedActorSystem	system()
scala.concurrent.Future<Done>	upsertObject(java.lang.String persistenceId, long revision, A value, java.lang.String tag)
scala.concurrent.Future<Done>	upsertObject(java.lang.String persistenceId, long revision, A value, java.lang.String tag, java.lang.Object changeEvent)	The changeEvent is written to the event journal.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PersistenceTestKitDurableStateStore

public PersistenceTestKitDurableStateStore(ExtendedActorSystem system)

Method Detail

Identifier

public static java.lang.String Identifier()

system

public ExtendedActorSystem system()

getObject

public scala.concurrent.Future<GetObjectResult<A>> getObject(java.lang.String persistenceId)

Specified by:

getObject in interface DurableStateStore<A>

upsertObject

public scala.concurrent.Future<Done> upsertObject(java.lang.String persistenceId,
                                                  long revision,
                                                  A value,
                                                  java.lang.String tag)

Specified by:

upsertObject in interface DurableStateUpdateStore<A>

revision - sequence number for optimistic locking. starts at 1.

upsertObject

public scala.concurrent.Future<Done> upsertObject(java.lang.String persistenceId,
                                                  long revision,
                                                  A value,
                                                  java.lang.String tag,
                                                  java.lang.Object changeEvent)

Description copied from interface: DurableStateUpdateWithChangeEventStore

The changeEvent is written to the event journal. Same persistenceId is used in the journal and the revision is used as sequenceNr.

Specified by:

upsertObject in interface DurableStateUpdateWithChangeEventStore<A>

revision - sequence number for optimistic locking. starts at 1.

deleteObject

public scala.concurrent.Future<Done> deleteObject(java.lang.String persistenceId)

Specified by:

deleteObject in interface DurableStateUpdateStore<A>

deleteObject

public scala.concurrent.Future<Done> deleteObject(java.lang.String persistenceId,
                                                  long revision)

Specified by:

deleteObject in interface DurableStateUpdateStore<A>

deleteObject

public scala.concurrent.Future<Done> deleteObject(java.lang.String persistenceId,
                                                  long revision,
                                                  java.lang.Object changeEvent)

Specified by:

deleteObject in interface DurableStateUpdateWithChangeEventStore<A>

changes

public Source<DurableStateChange<A>,NotUsed> changes(java.lang.String tag,
                                                           Offset offset)

Description copied from interface: DurableStateStoreQuery

Get a source of the most recent changes made to objects of the given tag since the passed in offset.

The returned source will never terminate, it effectively watches for changes to the objects and emits changes as they happen.

Not all changes that occur are guaranteed to be emitted, this call only guarantees that eventually, the most recent change for each object since the offset will be emitted. In particular, multiple updates to a given object in quick succession are likely to be skipped, with only the last update resulting in a change from this source.

The DurableStateChange elements can be UpdatedDurableState or DeletedDurableState.

Specified by:

changes in interface DurableStateStoreQuery<A>

Parameters:

tag - The tag to get changes for.

offset - The offset to get changes since. Must either be NoOffset to get changes since the beginning of time, or an offset that has been previously returned by this query. Any other offsets are invalid.

Returns:

A source of change in state.

currentChanges

public Source<DurableStateChange<A>,NotUsed> currentChanges(java.lang.String tag,
                                                                  Offset offset)

Description copied from interface: DurableStateStoreQuery

Get a source of the most recent changes made to objects with the given tag since the passed in offset.

Note that this only returns the most recent change to each object, if an object has been updated multiple times since the offset, only the most recent of those changes will be part of the stream.

This will return changes that occurred up to when the Source returned by this call is materialized. Changes to objects made since materialization are not guaranteed to be included in the results.

The DurableStateChange elements can be UpdatedDurableState or DeletedDurableState.

Specified by:

currentChanges in interface DurableStateStoreQuery<A>

Parameters:

tag - The tag to get changes for.

offset - The offset to get changes since. Must either be NoOffset to get changes since the beginning of time, or an offset that has been previously returned by this query. Any other offsets are invalid.

Returns:

A source of change in state.

currentChangesBySlices

public Source<DurableStateChange<A>,NotUsed> currentChangesBySlices(java.lang.String entityType,
                                                                          int minSlice,
                                                                          int maxSlice,
                                                                          Offset offset)

Description copied from interface: DurableStateStoreBySliceQuery

Get a source of the most recent changes made to objects with the given slice range since the passed in offset.

A slice is deterministically defined based on the persistence id. The purpose is to evenly distribute all persistence ids over the slices.

Note that this only returns the most recent change to each object, if an object has been updated multiple times since the offset, only the most recent of those changes will be part of the stream.

This will return changes that occurred up to when the Source returned by this call is materialized. Changes to objects made since materialization are not guaranteed to be included in the results.

The DurableStateChange elements can be UpdatedDurableState or DeletedDurableState.

Specified by:

currentChangesBySlices in interface DurableStateStoreBySliceQuery<A>

changesBySlices

public Source<DurableStateChange<A>,NotUsed> changesBySlices(java.lang.String entityType,
                                                                   int minSlice,
                                                                   int maxSlice,
                                                                   Offset offset)

Description copied from interface: DurableStateStoreBySliceQuery

Get a source of the most recent changes made to objects of the given slice range since the passed in offset.

A slice is deterministically defined based on the persistence id. The purpose is to evenly distribute all persistence ids over the slices.

The returned source will never terminate, it effectively watches for changes to the objects and emits changes as they happen.

Not all changes that occur are guaranteed to be emitted, this call only guarantees that eventually, the most recent change for each object since the offset will be emitted. In particular, multiple updates to a given object in quick succession are likely to be skipped, with only the last update resulting in a change from this source.

The DurableStateChange elements can be UpdatedDurableState or DeletedDurableState.

Specified by:

changesBySlices in interface DurableStateStoreBySliceQuery<A>

sliceForPersistenceId

public int sliceForPersistenceId(java.lang.String persistenceId)

Specified by:

sliceForPersistenceId in interface CurrentEventsBySliceQuery

Specified by:

sliceForPersistenceId in interface DurableStateStoreBySliceQuery<A>

Specified by:

sliceForPersistenceId in interface EventsBySliceQuery

sliceRanges

public scala.collection.immutable.Seq<scala.collection.immutable.Range> sliceRanges(int numberOfRanges)

Specified by:

sliceRanges in interface CurrentEventsBySliceQuery

Specified by:

sliceRanges in interface DurableStateStoreBySliceQuery<A>

Specified by:

sliceRanges in interface EventsBySliceQuery

currentPersistenceIds

public Source<java.lang.String,NotUsed> currentPersistenceIds(scala.Option<java.lang.String> afterId,
                                                                    long limit)

Description copied from interface: DurableStateStorePagedPersistenceIdsQuery

Get the current persistence ids.

Not all plugins may support in database paging, and may simply use drop/take Akka streams operators to manipulate the result set according to the paging parameters.

Specified by:

currentPersistenceIds in interface DurableStateStorePagedPersistenceIdsQuery<A>

Parameters:

afterId - The ID to start returning results from, or None to return all ids. This should be an id returned from a previous invocation of this command. Callers should not assume that ids are returned in sorted order.

limit - The maximum results to return. Use Long.MaxValue to return all results. Must be greater than zero.

Returns:

A source containing all the persistence ids, limited as specified.

currentEventsBySlices

public <Event> Source<EventEnvelope<Event>,NotUsed> currentEventsBySlices(java.lang.String entityType,
                                                                                int minSlice,
                                                                                int maxSlice,
                                                                                Offset offset)

For change events.

Specified by:

currentEventsBySlices in interface CurrentEventsBySliceQuery

eventsBySlices

public <Event> Source<EventEnvelope<Event>,NotUsed> eventsBySlices(java.lang.String entityType,
                                                                         int minSlice,
                                                                         int maxSlice,
                                                                         Offset offset)

For change events.

Specified by:

eventsBySlices in interface EventsBySliceQuery