wow-test/me.ahoo.wow.test.aggregate.dsl/ExpectDsl

ExpectDsl

interface ExpectDsl<S : Any> : AggregateExpecter<S, ExpectDsl<S>> , AggregateDslContextCapable<S>

Defines the "Expect" phase of aggregate testing where results are validated.

This interface extends AggregateExpecter to provide comprehensive assertion methods for validating command execution results, and adds the fork method for creating branching test scenarios.

Parameters

the type of the aggregate state

Inheritors

DefaultExpectDsl

Properties

context

abstract val context: AggregateDslContext<S>

The aggregate DSL context for managing shared test state.

Functions

expect

abstract fun expect(expected: ExpectedResult<S>.() -> Unit): ExpectDsl<S>

Applies custom expectations to the test result.

expectError

open fun expectError(): ExpectDsl<S>

Expects that an error occurred during command execution.

open fun <E : Throwable> expectError(expected: Consumer<E>): ExpectDsl<S>

Expects a specific error with detailed validation using a Consumer.

open fun <E : Throwable> expectError(expected: E.() -> Unit): ExpectDsl<S>

Expects a specific error with detailed validation.

expectErrorType

open fun <E : Throwable> expectErrorType(expected: Class<E>): ExpectDsl<S>

Expects an error of a specific type (Java-friendly overload).

open fun <E : Throwable> expectErrorType(expected: KClass<E>): ExpectDsl<S>

Expects an error of a specific type.

expectEvent

open fun <E : Any> expectEvent(expected: Consumer<DomainEvent<E>>): ExpectDsl<S>

Expects specific conditions on the first domain event using a Consumer.

open fun <E : Any> expectEvent(expected: DomainEvent<E>.() -> Unit): ExpectDsl<S>

Expects specific conditions on the first domain event in the stream.

expectEventBody

open fun <E : Any> expectEventBody(expected: Consumer<E>): ExpectDsl<S>

Expects specific conditions on the body of the first domain event using a Consumer.

open fun <E : Any> expectEventBody(expected: E.() -> Unit): ExpectDsl<S>

Expects specific conditions on the body of the first domain event.

expectEventCount

open fun expectEventCount(expected: Int): ExpectDsl<S>

Expects a specific number of events in the domain event stream.

expectEventIterator

open fun expectEventIterator(expected: Consumer<EventIterator>): ExpectDsl<S>

Expects specific conditions on an event iterator using a Consumer.

open fun expectEventIterator(expected: EventIterator.() -> Unit): ExpectDsl<S>

Expects specific conditions on an event iterator for the domain event stream.

expectEventStream

open fun expectEventStream(expected: Consumer<DomainEventStream>): ExpectDsl<S>

Expects specific conditions on the domain event stream using a Consumer.

open fun expectEventStream(expected: DomainEventStream.() -> Unit): ExpectDsl<S>

Expects specific conditions on the domain event stream.

expectEventType

open fun expectEventType(vararg expected: Class<*>): ExpectDsl<S>

Expects events of specific types in the exact order provided (Java-friendly overload).

open fun expectEventType(vararg expected: KClass<*>): ExpectDsl<S>

Expects events of specific types in the exact order provided.

expectNoError

open fun expectNoError(): ExpectDsl<S>

Expects that no error occurred during command execution.

expectState

open fun expectState(expected: Consumer<S>): ExpectDsl<S>

Expects specific conditions on the aggregate state object using a Consumer.

open fun expectState(expected: S.() -> Unit): ExpectDsl<S>

Expects specific conditions on the aggregate state object.

expectStateAggregate

open fun expectStateAggregate(expected: StateAggregate<S>.() -> Unit): ExpectDsl<S>

Expects specific conditions on the aggregate state and metadata.

fork

abstract fun fork(name: String = "", verifyError: Boolean = false, block: ForkedVerifiedStageDsl<S>.() -> Unit)

Creates a branching test scenario from the current verified state.

ref

abstract fun ref(ref: String)

Marks the current ExpectStage with a reference name for later branching.