org.axonframework.test.aggregate

Interface ResultValidator

All Known Implementing Classes:

ResultValidatorImpl

public interface ResultValidator

Interface describing the operations available on the "validate result" (a.k.a. "then") stage of the test execution. The underlying fixture expects a test to have been executed succesfully using a TestExecutor.

There are several things to validate:

• the published events,
• the stored events, and
• the command handler's execution result, which is one of
  • a regular return value,
  • a void return value, or
  • an exception.

Since:

0.6

Author:

Allard Buijze

Method Summary

Modifier and Type	Method and Description
ResultValidator	expectEvents(Object... expectedEvents) Expect the given set of events to have been published.
ResultValidator	expectEventsMatching(org.hamcrest.Matcher<? extends List<? super EventMessage<?>>> matcher) Expect the published events to match the given matcher.
ResultValidator	expectException(Class<? extends Throwable> expectedException) Expect the given expectedException to occur during command handler execution.
ResultValidator	expectException(org.hamcrest.Matcher<?> matcher) Expect an exception to occur during command handler execution that matches with the given matcher.
default ResultValidator	expectNoEvents() Expect no events to have been published from the command.
ResultValidator	expectReturnValue(Object expectedReturnValue) Expect the command handler to return the given expectedReturnValue after execution.
ResultValidator	expectReturnValueMatching(org.hamcrest.Matcher<?> matcher) Expect the command handler to return a value that matches the given matcher after execution.
ResultValidator	expectSuccessfulHandlerExecution() Expect a successful execution of the given command handler, regardless of the actual return value.

Method Detail

expectEvents

ResultValidator expectEvents(Object... expectedEvents)

Expect the given set of events to have been published.

All events are compared for equality using a shallow equals comparison on all the fields of the events. This means that all assigned values on the events' fields should have a proper equals implementation.

Note that the event identifier is ignored in the comparison.

Parameters:

expectedEvents - The expected events, in the exact order they are expected to be dispatched and stored.

Returns:

the current ResultValidator, for fluent interfacing

expectNoEvents

default ResultValidator expectNoEvents()

Expect no events to have been published from the command.

Returns:

the current ResultValidator, for fluent interfacing

expectEventsMatching

ResultValidator expectEventsMatching(org.hamcrest.Matcher<? extends List<? super EventMessage<?>>> matcher)

Expect the published events to match the given matcher.

Note: if no events were published, the matcher receives an empty List.

Parameters:

matcher - The matcher to match with the actually published events

Returns:

the current ResultValidator, for fluent interfacing

expectReturnValue

ResultValidator expectReturnValue(Object expectedReturnValue)

Expect the command handler to return the given expectedReturnValue after execution. The actual and expected values are compared using their equals methods.

Parameters:

expectedReturnValue - The expected return value of the command execution

Returns:

the current ResultValidator, for fluent interfacing

expectReturnValueMatching

ResultValidator expectReturnValueMatching(org.hamcrest.Matcher<?> matcher)

Expect the command handler to return a value that matches the given matcher after execution.

Parameters:

matcher - The matcher to verify the actual return value against

Returns:

the current ResultValidator, for fluent interfacing

expectException

ResultValidator expectException(Class<? extends Throwable> expectedException)

Expect the given expectedException to occur during command handler execution. The actual exception should be exactly of that type, subclasses are not accepted.

Parameters:

expectedException - The type of exception expected from the command handler execution

Returns:

the current ResultValidator, for fluent interfacing

expectException

ResultValidator expectException(org.hamcrest.Matcher<?> matcher)

Expect an exception to occur during command handler execution that matches with the given matcher.

Parameters:

matcher - The matcher to validate the actual exception

Returns:

the current ResultValidator, for fluent interfacing

expectSuccessfulHandlerExecution

ResultValidator expectSuccessfulHandlerExecution()

Expect a successful execution of the given command handler, regardless of the actual return value.

Returns:

the current ResultValidator, for fluent interfacing