Class PersistenceTestKitDurableStateStore<A>

    • Method Detail

      • Identifier

        public static java.lang.String Identifier()
      • upsertObject

        public java.util.concurrent.CompletionStage<Done> upsertObject​(java.lang.String persistenceId,
                                                                       long seqNr,
                                                                       A value,
                                                                       java.lang.String tag)
        Specified by:
        upsertObject in interface DurableStateUpdateStore<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. DeletedDurableState is not implemented yet, see issue https://github.com/akka/akka/issues/30446.

        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. DeletedDurableState is not implemented yet, see issue https://github.com/akka/akka/issues/30446.

        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.
      • currentPersistenceIds

        public Source<java.lang.String,​NotUsed> currentPersistenceIds​(java.util.Optional<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 empty 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.MAX_VALUE to return all results. Must be greater than zero.
        Returns:
        A source containing all the persistence ids, limited as specified.