Package com.opencqrs.framework.command

Class CommandHandlingTestFixture.EventAsserter

java.lang.Object

com.opencqrs.framework.command.CommandHandlingTestFixture.EventAsserter

Enclosing class:

CommandHandlingTestFixture<I,C extends Command,R>

public static class CommandHandlingTestFixture.EventAsserter
extends Object

Fluent API helper class for asserting a captured events.

See Also:

• CommandHandlingTestFixture.Expect.expectNextEvent(Consumer)
• CommandHandlingTestFixture.Expect.expectSingleEvent(Consumer)
• CommandHandlingTestFixture.Expect.expectAnyEvent(Consumer)

Method Summary

Modifier and Type	Method	Description
CommandHandlingTestFixture.EventAsserter	commandSubject()	Verifies that the captured event was published for the Command.getSubject().
CommandHandlingTestFixture.EventAsserter	metaData(Map<String,?> expected)	Asserts that the captured event meta-data is equal to the expected one.
CommandHandlingTestFixture.EventAsserter	metaDataSatisfying(Consumer<Map<String,?>> assertion)	Verifies that the captured event meta-data asserts successfully using the given custom assertion.
CommandHandlingTestFixture.EventAsserter	noMetaData()	Verifies that no (aka empty) meta-data was published for the captured event.
<E> CommandHandlingTestFixture.EventAsserter	payload(E expected)	Asserts that the captured event payload is equal to the expected one.
<E, R> CommandHandlingTestFixture.EventAsserter	payloadExtracting(Function<E,R> extractor, R expected)	Asserts that the captured event's payload property from the given extractor function is equal to the expected one.
<E> CommandHandlingTestFixture.EventAsserter	payloadSatisfying(Consumer<E> assertion)	Verifies that the captured event payload asserts successfully using the given custom assertion.
CommandHandlingTestFixture.EventAsserter	payloadType(Class<?> type)	Asserts that the captured event payload Class.isAssignableFrom(Class) is assignable to} the expected type
CommandHandlingTestFixture.EventAsserter	subject(String expected)	Asserts that the captured event subject is equal to the expected one.
CommandHandlingTestFixture.EventAsserter	subjectSatisfying(Consumer<String> assertion)	Verifies that the captured event subject asserts successfully using the given custom assertion.

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)

Asserts that the captured event payload Class.isAssignableFrom(Class) is assignable to} the expected type

Parameters:

type - the assignable type

Returns:

this for further assertions

payload

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

Asserts that the captured event payload is equal to the expected one.

Type Parameters:

E - the generic payload type

Parameters:

expected - the expected event payload

Returns:

this for further assertions

Throws:

AssertionError - if the captured event payload is not equal to the expected one

payloadExtracting

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

Asserts that the captured event's payload property from the given extractor function is equal to the expected one.

Type Parameters:

E - the generic payload type

R - the generic extraction result type

Parameters:

extractor - the extractor function

expected - the expected event payload property, may be null

Returns:

this for further assertions

Throws:

AssertionError - if the extracted payload property is not equal to the expected value

payloadSatisfying

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

Verifies that the captured event payload asserts successfully using the given custom assertion.

Type Parameters:

E - the generic payload type

Parameters:

assertion - custom assertion

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the custom assertion

metaData

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

Asserts that the captured event meta-data is equal to the expected one.

Parameters:

expected - the expected event meta-data

Returns:

this for further assertions

Throws:

AssertionError - if the meta-data of the event is not as expected

metaDataSatisfying

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

Verifies that the captured event meta-data asserts successfully using the given custom assertion.

Parameters:

assertion - custom assertion

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the custom assertion

noMetaData

public CommandHandlingTestFixture.EventAsserter noMetaData()
                                                    throws AssertionError

Verifies that no (aka empty) meta-data was published for the captured event.

Returns:

this for further assertions

Throws:

AssertionError - if the meta-data is not empty

subject

public CommandHandlingTestFixture.EventAsserter subject(String expected)
                                                 throws AssertionError

Asserts that the captured event subject is equal to the expected one.

Parameters:

expected - the expected event subject

Returns:

this for further assertions

Throws:

AssertionError - if the event subject is not as expected

subjectSatisfying

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

Verifies that the captured event subject asserts successfully using the given custom assertion.

Parameters:

assertion - custom assertion

Returns:

this for further assertions

Throws:

AssertionError - if thrown by the custom assertion

commandSubject

public CommandHandlingTestFixture.EventAsserter commandSubject()
                                                        throws AssertionError

Verifies that the captured event was published for the Command.getSubject().

Returns:

this for further assertions

Throws:

AssertionError - if the published event subject differs from the command's subject