Package org.apache.pekko.persistence.testkit.state.scaladsl

Class PersistenceTestKitDurableStateStore<A>

java.lang.Object
org.apache.pekko.persistence.testkit.state.scaladsl.PersistenceTestKitDurableStateStore<A>
All Implemented Interfaces:
DurableStateStorePagedPersistenceIdsQuery<A>, DurableStateStoreQuery<A>, DurableStateStoreBySliceQuery<A>, DurableStateStore<A>, DurableStateUpdateStore<A>
public class PersistenceTestKitDurableStateStore<A> extends Object implements DurableStateUpdateStore<A>, DurableStateStoreQuery<A>, DurableStateStoreBySliceQuery<A>, DurableStateStorePagedPersistenceIdsQuery<A>

  • Constructor Details

    • PersistenceTestKitDurableStateStore

      public PersistenceTestKitDurableStateStore(ExtendedActorSystem system)

  • Method Details

    • Identifier

      public static String Identifier()

    • system

      public ExtendedActorSystem system()

    • getObject

      public scala.concurrent.Future<GetObjectResult<A>> getObject(String persistenceId)
      Specified by:
      getObject in interface DurableStateStore<A>

    • upsertObject

      public scala.concurrent.Future<Done> upsertObject(String persistenceId, long revision, A value, String tag)
      Description copied from interface: DurableStateUpdateStore
      Upsert the object with the given persistenceId and revision.

      Specified by:
      upsertObject in interface DurableStateUpdateStore<A>
      Parameters:
      persistenceId - the persistenceId of the object to upsert
      revision - the revision of the object to upsert
      value - the value to upsert
      tag - a tag to associate with the object
      Returns:
      a Future that completes when the object has been upserted

    • deleteObject

      public scala.concurrent.Future<Done> deleteObject(String persistenceId)
      Description copied from interface: DurableStateUpdateStore
      Delete the object with the given persistenceId. This deprecated function ignores whether the object is deleted or not.

      Specified by:
      deleteObject in interface DurableStateUpdateStore<A>
      Parameters:
      persistenceId - the persistenceId of the object to delete
      Returns:
      a Future that completes when the object has been deleted

    • deleteObject

      public scala.concurrent.Future<Done> deleteObject(String persistenceId, long revision)
      Description copied from interface: DurableStateUpdateStore
      Delete the object with the given persistenceId and revision.

      Since Pekko v1.1, if the revision does not match the current revision of the object, the delete operation will fail. The returned Future will complete with a failed result wrapping the exception.

      Specified by:
      deleteObject in interface DurableStateUpdateStore<A>
      Parameters:
      persistenceId - the persistenceId of the object to delete
      revision - the revision of the object to delete
      Returns:
      a Future that completes when the object has been deleted

    • changes

      public Source<DurableStateChange<A>,NotUsed> changes(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 pekko.persistence.query.DurableStateChange elements can be pekko.persistence.query.UpdatedDurableState or pekko.persistence.query.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 pekko.persistence.query.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(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 pekko.persistence.query.DurableStateChange elements can be pekko.persistence.query.UpdatedDurableState or pekko.persistence.query.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 pekko.persistence.query.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(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 pekko.persistence.query.DurableStateChange elements can be pekko.persistence.query.UpdatedDurableState or pekko.persistence.query.DeletedDurableState.

      Specified by:
      currentChangesBySlices in interface DurableStateStoreBySliceQuery<A>

    • changesBySlices

      public Source<DurableStateChange<A>,NotUsed> changesBySlices(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 pekko.persistence.query.DurableStateChange elements can be pekko.persistence.query.UpdatedDurableState or pekko.persistence.query.DeletedDurableState.

      Specified by:
      changesBySlices in interface DurableStateStoreBySliceQuery<A>

    • sliceForPersistenceId

      public int sliceForPersistenceId(String persistenceId)
      Specified by:
      sliceForPersistenceId in interface DurableStateStoreBySliceQuery<A>

    • sliceRanges

      public scala.collection.immutable.Seq<scala.collection.immutable.Range> sliceRanges(int numberOfRanges)
      Specified by:
      sliceRanges in interface DurableStateStoreBySliceQuery<A>

    • currentPersistenceIds

      public Source<String,NotUsed> currentPersistenceIds(scala.Option<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 Pekko 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.