Package com.opencqrs.framework.command

Class CommandHandlingTestFixture.EventAsserter

java.lang.Object

com.opencqrs.framework.command.CommandHandlingTestFixture.EventAsserter

All Implemented Interfaces:

EventAsserting

Enclosing class:

CommandHandlingTestFixture<C extends Command>

public static class CommandHandlingTestFixture.EventAsserter
extends Object
implements EventAsserting

Fluent API helper class for asserting captured events.

See Also:

• ExpectDsl.EventValidator.asserting(Consumer)

Method Summary

Modifier and Type	Method	Description
CommandHandlingTestFixture.EventAsserter	commandSubject()	Asserts that the event subject equals the command's subject.
CommandHandlingTestFixture.EventAsserter	metaData(Map<String,?> expected)	Asserts that the event meta-data equals the expected map using Object.equals(Object).
CommandHandlingTestFixture.EventAsserter	metaDataSatisfying(Consumer<Map<String,?>> assertion)	Asserts that the event meta-data satisfies custom assertions.
CommandHandlingTestFixture.EventAsserter	noMetaData()	Asserts that the event has no meta-data (empty map).
<E> CommandHandlingTestFixture.EventAsserter	payload(E expected)	Asserts that the event payload equals the expected value using Object.equals(Object).
<E, R> CommandHandlingTestFixture.EventAsserter	payloadExtracting(Function<E,R> extractor, R expected)	Extracts a value from the event payload and asserts it equals the expected value.
<E> CommandHandlingTestFixture.EventAsserter	payloadSatisfying(Consumer<E> assertion)	Asserts that the event payload satisfies custom assertions.
CommandHandlingTestFixture.EventAsserter	payloadType(Class<?> type)	Asserts that the event payload is an instance of the specified type.
CommandHandlingTestFixture.EventAsserter	subject(String expected)	Asserts that the event subject equals the expected value.
CommandHandlingTestFixture.EventAsserter	subjectSatisfying(Consumer<String> assertion)	Asserts that the event subject satisfies custom assertions.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

payloadType

public CommandHandlingTestFixture.EventAsserter payloadType(Class<?> type)

Description copied from interface: EventAsserting

Asserts that the event payload is an instance of the specified type.

Specified by:

payloadType in interface EventAsserting

Parameters:

type - the expected payload class

Returns:

this for further assertions

payload

public <E> CommandHandlingTestFixture.EventAsserter payload(E expected)
                                                     throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event payload equals the expected value using Object.equals(Object).

Specified by:

payload in interface EventAsserting

Type Parameters:

E - the payload type

Parameters:

expected - the expected payload

Returns:

this for further assertions

Throws:

AssertionError - if the payloads are not equal

payloadExtracting

public <E,
R>
CommandHandlingTestFixture.EventAsserter payloadExtracting(Function<E,R> extractor,
 R expected)
                                                    throws AssertionError

Description copied from interface: EventAsserting

Extracts a value from the event payload and asserts it equals the expected value. Useful for comparing specific fields without matching the entire payload.

Example: a.payloadExtracting((MyEvent e) -> e.name(), "expected-name")

Specified by:

payloadExtracting in interface EventAsserting

Type Parameters:

E - the payload type

R - the extracted value type

Parameters:

extractor - function to extract a value from the payload

expected - the expected extracted value (may be null)

Returns:

this for further assertions

Throws:

AssertionError - if the extracted values are not equal

payloadSatisfying

public <E> CommandHandlingTestFixture.EventAsserter payloadSatisfying(Consumer<E> assertion)
                                                               throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event payload satisfies custom assertions.

Specified by:

payloadSatisfying in interface EventAsserting

Type Parameters:

E - the payload type

Parameters:

assertion - consumer receiving the payload

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the consumer

metaData

public CommandHandlingTestFixture.EventAsserter metaData(Map<String,?> expected)
                                                  throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event meta-data equals the expected map using Object.equals(Object).

Specified by:

metaData in interface EventAsserting

Parameters:

expected - the expected meta-data

Returns:

this for further assertions

Throws:

AssertionError - if the meta-data maps are not equal

metaDataSatisfying

public CommandHandlingTestFixture.EventAsserter metaDataSatisfying(Consumer<Map<String,?>> assertion)
                                                            throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event meta-data satisfies custom assertions.

Specified by:

metaDataSatisfying in interface EventAsserting

Parameters:

assertion - consumer receiving the meta-data map

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the consumer

noMetaData

public CommandHandlingTestFixture.EventAsserter noMetaData()
                                                    throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event has no meta-data (empty map).

Specified by:

noMetaData in interface EventAsserting

Returns:

this for further assertions

Throws:

AssertionError - if the meta-data is not empty

subject

public CommandHandlingTestFixture.EventAsserter subject(String expected)
                                                 throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event subject equals the expected value.

Specified by:

subject in interface EventAsserting

Parameters:

expected - the expected subject

Returns:

this for further assertions

Throws:

AssertionError - if the subjects are not equal

subjectSatisfying

public CommandHandlingTestFixture.EventAsserter subjectSatisfying(Consumer<String> assertion)
                                                           throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event subject satisfies custom assertions.

Specified by:

subjectSatisfying in interface EventAsserting

Parameters:

assertion - consumer receiving the subject

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the consumer

commandSubject

public CommandHandlingTestFixture.EventAsserter commandSubject()
                                                        throws AssertionError

Description copied from interface: EventAsserting

Asserts that the event subject equals the command's subject. Convenience method equivalent to subject(command.getSubject()).

Specified by:

commandSubject in interface EventAsserting

Returns:

this for further assertions

Throws:

AssertionError - if the subjects do not match