wow-test/me.ahoo.wow.test.aggregate/GivenStage

GivenStage

interface GivenStage<S : Any> : InjectServiceCapable<GivenStage<S>>

Defines the stage for setting up test preconditions in aggregate testing.

This interface provides methods to configure the initial state of aggregates before command execution, including injecting services, setting owner IDs, and providing initial events or state.

Parameters

the type of the aggregate state

Inheritors

VerifiedStage

Functions

given

open fun given(vararg events: Any): WhenStage<S>

Sets up the aggregate by replaying the given domain events.

givenEvent

abstract fun givenEvent(vararg events: Any): WhenStage<S>

givenOwnerId

abstract fun givenOwnerId(ownerId: String): GivenStage<S>

Sets the owner ID for the aggregate in this test.

givenState

abstract fun givenState(state: StateAggregate<S>): WhenStage<S>

abstract fun givenState(state: S, version: Int): WhenStage<S>

inject

open fun <SERVICE : Any> inject(service: SERVICE, serviceName: String = service.javaClass.toName(), serviceType: KType = service.javaClass.kotlin.defaultType): GivenStage<S>

Injects a service instance into the test context.

abstract fun inject(inject: ServiceProvider.() -> Unit): GivenStage<S>

Injects services into the test context using the provided configuration block.

when

fun <S : Any> GivenStage<S>.when(command: Any, header: Header = DefaultHeader.empty(), ownerId: String = OwnerId.DEFAULT_OWNER_ID): ExpectStage<S>

Alias for whenCommand, providing a more natural language interface.

whenCommand

fun <S : Any> GivenStage<S>.whenCommand(command: Any, header: Header = DefaultHeader.empty(), ownerId: String = OwnerId.DEFAULT_OWNER_ID): ExpectStage<S>

Extension function that allows executing a command directly from the Given stage.