Class PersistenceTestKit
- java.lang.Object
-
- org.apache.pekko.persistence.testkit.javadsl.PersistenceTestKit
-
public class PersistenceTestKit extends java.lang.Object
Class for testing persisted events in persistent actors.
-
-
Constructor Summary
Constructors Constructor Description PersistenceTestKit(ActorSystem system)
PersistenceTestKit(PersistenceTestKit scalaTestkit)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
clearAll()
Clear all data from storage.void
clearAllPreservingSeqNumbers()
Clear all data in storage preserving sequence numbers.void
clearByIdPreservingSeqNumbers(java.lang.String persistenceId)
Clear all data in storage for particular persistence id preserving sequence numbers.void
clearByPersistenceId(java.lang.String persistenceId)
Clear all data from storage for particular persistence id.static PersistenceTestKit
create(ActorSystem system)
static PersistenceTestKit
create(ActorSystem<?> system)
<A> A
expectNextPersisted(java.lang.String persistenceId, A event)
Check thatevent
has been saved in the storage.<A> A
expectNextPersisted(java.lang.String persistenceId, A event, java.time.Duration max)
Check formax
time thatevent
has been saved in the storage.<A> A
expectNextPersistedClass(java.lang.String persistenceId, java.lang.Class<A> cla)
Check that next persisted in storage for particular persistence id event has expected type.<A> A
expectNextPersistedClass(java.lang.String persistenceId, java.lang.Class<A> cla, java.time.Duration max)
Check formax
time that next persisted in storage for particular persistence id event has expected type.void
expectNothingPersisted(java.lang.String persistenceId)
Check that nothing has been saved in the storage.void
expectNothingPersisted(java.lang.String persistenceId, java.time.Duration max)
Check formax
time that nothing has been saved in the storage.void
failNextDelete()
Fail next delete from storage attempt with default exception for any persistence id.void
failNextDelete(java.lang.String persistenceId)
Fail next delete from storage attempt with default exception for particular persistence id.void
failNextDelete(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next delete from storage attempt withcause
exception for particular persistence id.void
failNextDelete(java.lang.Throwable cause)
Fail next delete from storage attempt withcause
exception for any persistence id.void
failNextNDeletes(int n)
Fail next n delete from storage attempts with default exception for any persistence id.void
failNextNDeletes(int n, java.lang.Throwable cause)
Fail next n delete from storage attempts withcause
exception for any persistence id.void
failNextNDeletes(java.lang.String persistenceId, int n)
Fail next n delete from storage attempts with default exception for particular persistence id.void
failNextNDeletes(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail next n delete from storage attempts withcause
exception for particular persistence id.void
failNextNOps(int n)
Fail n following journal operations regardless of their type.void
failNextNOps(int n, java.lang.Throwable cause)
Failn
following journal operations depending on the conditioncond
.void
failNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n)
Failn
following journal operations depending on the conditioncond
.void
failNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n, java.lang.Throwable cause)
Failn
following journal operations depending on the conditioncond
.void
failNextNPersisted(int n)
Fail nextn
write operations with default exception for any persistence id.void
failNextNPersisted(int n, java.lang.Throwable cause)
Fail nextn
write operations with thecause
exception for any persistence id.void
failNextNPersisted(java.lang.String persistenceId, int n)
Fail nextn
write operations for particular persistence id.void
failNextNPersisted(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail nextn
write operations with thecause
exception for particular persistence id.void
failNextNReads(int n)
Fail next n read from storage (recovery) attempts with default exception for any persistence id.void
failNextNReads(int n, java.lang.Throwable cause)
Fail next n read from storage (recovery) attempts withcause
exception for any persistence id.void
failNextNReads(java.lang.String persistenceId, int n)
Fail next n read from storage (recovery) attempts with default exception for particular persistence id.void
failNextNReads(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail next n read from storage (recovery) attempts withcause
exception for particular persistence id.void
failNextPersisted()
Fail next write operation with default exception for any persistence id.void
failNextPersisted(java.lang.String persistenceId)
Fail next write operation with default exception for particular persistence id.void
failNextPersisted(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next write operation withcause
exception for particular persistence id.void
failNextPersisted(java.lang.Throwable cause)
Fail next write operation event withcause
exception for any persistence id.void
failNextRead()
Fail next read from storage (recovery) attempt with default exception for any persistence id.void
failNextRead(java.lang.String persistenceId)
Fail next read from storage (recovery) attempt with default exception for any persistence id.void
failNextRead(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next read from storage (recovery) attempt withcause
exception for particular persistence id.void
failNextRead(java.lang.Throwable cause)
Fail next read from storage (recovery) attempt withcause
exception for any persistence id.java.util.List<java.lang.Object>
persistedInStorage(java.lang.String persistenceId)
Retrieve all events saved in storage by persistence id.void
persistForRecovery(java.lang.String persistenceId, java.util.List<java.lang.Object> events)
Persistevents
into storage in order.<A> java.util.List<A>
receivePersisted(java.lang.String persistenceId, int n, java.lang.Class<A> cla)
Receive next n events from the storage.<A> java.util.List<A>
receivePersisted(java.lang.String persistenceId, int n, java.lang.Class<A> cla, java.time.Duration max)
Receive formax
time next n events from the storage.void
rejectNextDelete()
Reject next delete from storage operation for any persistence id with default exception.void
rejectNextDelete(java.lang.String persistenceId)
Reject next delete from storage operations for particular persistence id with default exception.void
rejectNextDelete(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next delete from storage operations for particular persistence id withcause
exception.void
rejectNextDelete(java.lang.Throwable cause)
Reject next delete from storage operation for any persistence id withcause
exception.void
rejectNextNDeletes(int n)
Reject next n delete from storage operations for any persistence id with default exception.void
rejectNextNDeletes(int n, java.lang.Throwable cause)
Reject next n delete from storage operations for any persistence id withcause
exception.void
rejectNextNDeletes(java.lang.String persistenceId, int n)
Reject next n delete from storage operations for particular persistence id with default exception.void
rejectNextNDeletes(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n delete from storage operations for particular persistence id withcause
exception.void
rejectNextNOps(int n)
Reject n following journal operations regardless of their type.void
rejectNextNOps(int n, java.lang.Throwable cause)
Rejectn
following journal operations regardless of their type.void
rejectNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n)
Rejectn
following journal operations depending on the conditioncond
.void
rejectNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n, java.lang.Throwable cause)
Rejectn
following journal operations depending on the conditioncond
.void
rejectNextNPersisted(int n)
Reject next n save in storage operations for any persistence id with default exception.void
rejectNextNPersisted(int n, java.lang.Throwable cause)
Reject next n save in storage operations for any persistence id withcause
exception.void
rejectNextNPersisted(java.lang.String persistenceId, int n)
Reject next n save in storage operations for particular persistence id with default exception.void
rejectNextNPersisted(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n save in storage operations for particular persistence id withcause
exception.void
rejectNextNReads(int n)
Reject next n read from storage operations for any persistence id with default exception.void
rejectNextNReads(int n, java.lang.Throwable cause)
Reject next n read from storage operations for any persistence id withcause
exception.void
rejectNextNReads(java.lang.String persistenceId, int n)
Reject next n read from storage operations for particular persistence id with default exception.void
rejectNextNReads(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n read from storage operations for particular persistence id withcause
exception.void
rejectNextPersisted()
Reject next save in storage operation for any persistence id with default exception.void
rejectNextPersisted(java.lang.String persistenceId)
Reject next save in storage operation for particular persistence id with default exception.void
rejectNextPersisted(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next save in storage operation for particular persistence id withcause
exception.void
rejectNextPersisted(java.lang.Throwable cause)
Reject next save in storage operation for any persistence id withcause
exception.void
rejectNextRead()
Reject next read from storage operation for any persistence id with default exception.void
rejectNextRead(java.lang.String persistenceId)
Reject next read from storage operation for particular persistence id with default exception.void
rejectNextRead(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next read from storage operation for particular persistence id withcause
exception.void
rejectNextRead(java.lang.Throwable cause)
Reject next read from storage operation for any persistence id withcause
exception.void
resetPolicy()
Returns default policy if it was changed bywithPolicy(org.apache.pekko.persistence.testkit.ProcessingPolicy<org.apache.pekko.persistence.testkit.JournalOperation>)
.PersistenceTestKit
withPolicy(ProcessingPolicy<JournalOperation> policy)
Set new processing policy for journal operations.
-
-
-
Constructor Detail
-
PersistenceTestKit
public PersistenceTestKit(PersistenceTestKit scalaTestkit)
-
PersistenceTestKit
public PersistenceTestKit(ActorSystem system)
-
-
Method Detail
-
create
public static PersistenceTestKit create(ActorSystem system)
-
create
public static PersistenceTestKit create(ActorSystem<?> system)
-
expectNothingPersisted
public void expectNothingPersisted(java.lang.String persistenceId)
Check that nothing has been saved in the storage.
-
expectNothingPersisted
public void expectNothingPersisted(java.lang.String persistenceId, java.time.Duration max)
Check formax
time that nothing has been saved in the storage.
-
expectNextPersisted
public <A> A expectNextPersisted(java.lang.String persistenceId, A event)
Check thatevent
has been saved in the storage.
-
expectNextPersisted
public <A> A expectNextPersisted(java.lang.String persistenceId, A event, java.time.Duration max)
Check formax
time thatevent
has been saved in the storage.
-
expectNextPersistedClass
public <A> A expectNextPersistedClass(java.lang.String persistenceId, java.lang.Class<A> cla)
Check that next persisted in storage for particular persistence id event has expected type.
-
expectNextPersistedClass
public <A> A expectNextPersistedClass(java.lang.String persistenceId, java.lang.Class<A> cla, java.time.Duration max)
Check formax
time that next persisted in storage for particular persistence id event has expected type.
-
failNextNPersisted
public void failNextNPersisted(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail nextn
write operations with thecause
exception for particular persistence id.
-
failNextNPersisted
public void failNextNPersisted(java.lang.String persistenceId, int n)
Fail nextn
write operations for particular persistence id.
-
failNextNPersisted
public void failNextNPersisted(int n, java.lang.Throwable cause)
Fail nextn
write operations with thecause
exception for any persistence id.
-
failNextNPersisted
public void failNextNPersisted(int n)
Fail nextn
write operations with default exception for any persistence id.
-
failNextPersisted
public void failNextPersisted(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next write operation withcause
exception for particular persistence id.
-
failNextPersisted
public void failNextPersisted(java.lang.String persistenceId)
Fail next write operation with default exception for particular persistence id.
-
failNextPersisted
public void failNextPersisted(java.lang.Throwable cause)
Fail next write operation event withcause
exception for any persistence id.
-
failNextPersisted
public void failNextPersisted()
Fail next write operation with default exception for any persistence id.
-
failNextRead
public void failNextRead(java.lang.Throwable cause)
Fail next read from storage (recovery) attempt withcause
exception for any persistence id.
-
failNextRead
public void failNextRead()
Fail next read from storage (recovery) attempt with default exception for any persistence id.
-
failNextRead
public void failNextRead(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next read from storage (recovery) attempt withcause
exception for particular persistence id.
-
failNextRead
public void failNextRead(java.lang.String persistenceId)
Fail next read from storage (recovery) attempt with default exception for any persistence id.
-
failNextNReads
public void failNextNReads(int n, java.lang.Throwable cause)
Fail next n read from storage (recovery) attempts withcause
exception for any persistence id.
-
failNextNReads
public void failNextNReads(int n)
Fail next n read from storage (recovery) attempts with default exception for any persistence id.
-
failNextNReads
public void failNextNReads(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail next n read from storage (recovery) attempts withcause
exception for particular persistence id.
-
failNextNReads
public void failNextNReads(java.lang.String persistenceId, int n)
Fail next n read from storage (recovery) attempts with default exception for particular persistence id.
-
failNextDelete
public void failNextDelete(java.lang.Throwable cause)
Fail next delete from storage attempt withcause
exception for any persistence id.
-
failNextDelete
public void failNextDelete()
Fail next delete from storage attempt with default exception for any persistence id.
-
failNextDelete
public void failNextDelete(java.lang.String persistenceId, java.lang.Throwable cause)
Fail next delete from storage attempt withcause
exception for particular persistence id.
-
failNextDelete
public void failNextDelete(java.lang.String persistenceId)
Fail next delete from storage attempt with default exception for particular persistence id.
-
failNextNDeletes
public void failNextNDeletes(int n, java.lang.Throwable cause)
Fail next n delete from storage attempts withcause
exception for any persistence id.
-
failNextNDeletes
public void failNextNDeletes(int n)
Fail next n delete from storage attempts with default exception for any persistence id.
-
failNextNDeletes
public void failNextNDeletes(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Fail next n delete from storage attempts withcause
exception for particular persistence id.
-
failNextNDeletes
public void failNextNDeletes(java.lang.String persistenceId, int n)
Fail next n delete from storage attempts with default exception for particular persistence id.
-
receivePersisted
public <A> java.util.List<A> receivePersisted(java.lang.String persistenceId, int n, java.lang.Class<A> cla)
Receive next n events from the storage.
-
receivePersisted
public <A> java.util.List<A> receivePersisted(java.lang.String persistenceId, int n, java.lang.Class<A> cla, java.time.Duration max)
Receive formax
time next n events from the storage.
-
rejectNextNPersisted
public void rejectNextNPersisted(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n save in storage operations for particular persistence id withcause
exception.
-
rejectNextNPersisted
public void rejectNextNPersisted(java.lang.String persistenceId, int n)
Reject next n save in storage operations for particular persistence id with default exception.
-
rejectNextNPersisted
public void rejectNextNPersisted(int n)
Reject next n save in storage operations for any persistence id with default exception.
-
rejectNextNPersisted
public void rejectNextNPersisted(int n, java.lang.Throwable cause)
Reject next n save in storage operations for any persistence id withcause
exception.
-
rejectNextPersisted
public void rejectNextPersisted(java.lang.String persistenceId)
Reject next save in storage operation for particular persistence id with default exception.
-
rejectNextPersisted
public void rejectNextPersisted(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next save in storage operation for particular persistence id withcause
exception.
-
rejectNextPersisted
public void rejectNextPersisted(java.lang.Throwable cause)
Reject next save in storage operation for any persistence id withcause
exception.
-
rejectNextPersisted
public void rejectNextPersisted()
Reject next save in storage operation for any persistence id with default exception.
-
rejectNextRead
public void rejectNextRead()
Reject next read from storage operation for any persistence id with default exception.
-
rejectNextRead
public void rejectNextRead(java.lang.Throwable cause)
Reject next read from storage operation for any persistence id withcause
exception.
-
rejectNextNReads
public void rejectNextNReads(int n)
Reject next n read from storage operations for any persistence id with default exception.
-
rejectNextNReads
public void rejectNextNReads(int n, java.lang.Throwable cause)
Reject next n read from storage operations for any persistence id withcause
exception.
-
rejectNextRead
public void rejectNextRead(java.lang.String persistenceId)
Reject next read from storage operation for particular persistence id with default exception.
-
rejectNextRead
public void rejectNextRead(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next read from storage operation for particular persistence id withcause
exception.
-
rejectNextNReads
public void rejectNextNReads(java.lang.String persistenceId, int n)
Reject next n read from storage operations for particular persistence id with default exception.
-
rejectNextNReads
public void rejectNextNReads(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n read from storage operations for particular persistence id withcause
exception.
-
rejectNextDelete
public void rejectNextDelete()
Reject next delete from storage operation for any persistence id with default exception.
-
rejectNextDelete
public void rejectNextDelete(java.lang.Throwable cause)
Reject next delete from storage operation for any persistence id withcause
exception.
-
rejectNextNDeletes
public void rejectNextNDeletes(int n)
Reject next n delete from storage operations for any persistence id with default exception.
-
rejectNextNDeletes
public void rejectNextNDeletes(int n, java.lang.Throwable cause)
Reject next n delete from storage operations for any persistence id withcause
exception.
-
rejectNextDelete
public void rejectNextDelete(java.lang.String persistenceId)
Reject next delete from storage operations for particular persistence id with default exception.
-
rejectNextDelete
public void rejectNextDelete(java.lang.String persistenceId, java.lang.Throwable cause)
Reject next delete from storage operations for particular persistence id withcause
exception.
-
rejectNextNDeletes
public void rejectNextNDeletes(java.lang.String persistenceId, int n)
Reject next n delete from storage operations for particular persistence id with default exception.
-
rejectNextNDeletes
public void rejectNextNDeletes(java.lang.String persistenceId, int n, java.lang.Throwable cause)
Reject next n delete from storage operations for particular persistence id withcause
exception.
-
rejectNextNOpsCond
public void rejectNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n)
Rejectn
following journal operations depending on the conditioncond
. Rejection triggers, whencond
returns true. Reject operations with defaultExpectedRejection
exception.
-
rejectNextNOpsCond
public void rejectNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n, java.lang.Throwable cause)
Rejectn
following journal operations depending on the conditioncond
. Rejection triggers, whencond
returns true. Rejects operations with thecause
exception.
-
rejectNextNOps
public void rejectNextNOps(int n)
Reject n following journal operations regardless of their type. Rejects operations with defaultExpectedRejection
exception.
-
rejectNextNOps
public void rejectNextNOps(int n, java.lang.Throwable cause)
Rejectn
following journal operations regardless of their type. Rejects operations with thecause
exception.
-
persistForRecovery
public void persistForRecovery(java.lang.String persistenceId, java.util.List<java.lang.Object> events)
Persistevents
into storage in order.
-
persistedInStorage
public java.util.List<java.lang.Object> persistedInStorage(java.lang.String persistenceId)
Retrieve all events saved in storage by persistence id.
-
clearAll
public void clearAll()
Clear all data from storage.NOTE! Also clears sequence numbers in storage!
- See Also:
clearAllPreservingSeqNumbers()
-
clearByPersistenceId
public void clearByPersistenceId(java.lang.String persistenceId)
Clear all data from storage for particular persistence id.NOTE! Also clears sequence number in storage!
-
clearAllPreservingSeqNumbers
public void clearAllPreservingSeqNumbers()
Clear all data in storage preserving sequence numbers.- See Also:
clearAll()
-
clearByIdPreservingSeqNumbers
public void clearByIdPreservingSeqNumbers(java.lang.String persistenceId)
Clear all data in storage for particular persistence id preserving sequence numbers.- See Also:
clearByPersistenceId(java.lang.String)
-
failNextNOpsCond
public void failNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n)
Failn
following journal operations depending on the conditioncond
. Failure triggers, whencond
returns true. Fails operations with defaultExpectedFailure
exception.
-
failNextNOpsCond
public void failNextNOpsCond(java.util.function.BiFunction<java.lang.String,JournalOperation,java.lang.Object> cond, int n, java.lang.Throwable cause)
Failn
following journal operations depending on the conditioncond
. Failure triggers, whencond
returns true. Fails operations with thecause
exception.
-
failNextNOps
public void failNextNOps(int n)
Fail n following journal operations regardless of their type. Fails operations with defaultExpectedFailure
exception.
-
failNextNOps
public void failNextNOps(int n, java.lang.Throwable cause)
Failn
following journal operations depending on the conditioncond
. Failure triggers, whencond
returns true. Fails operations with thecause
exception.
-
withPolicy
public PersistenceTestKit withPolicy(ProcessingPolicy<JournalOperation> policy)
Set new processing policy for journal operations. NOTE! Overrides previously invokedfailNext...
orrejectNext...
-
resetPolicy
public void resetPolicy()
Returns default policy if it was changed bywithPolicy(org.apache.pekko.persistence.testkit.ProcessingPolicy<org.apache.pekko.persistence.testkit.JournalOperation>)
.
-
-