|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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
.
void
return value, or
Method Summary | |
---|---|
ResultValidator |
expectEvents(Object... expectedEvents)
Expect the given set of events to have been stored and published. |
ResultValidator |
expectEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> 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 . |
ResultValidator |
expectPublishedEvents(Object... expectedEvents)
Expect the given set of events to have been published on the events bus. |
ResultValidator |
expectPublishedEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> matcher)
Expect the list of published event to match the given matcher . |
ResultValidator |
expectReturnValue(org.hamcrest.Matcher<?> matcher)
Expect the command handler to return a value that matches the given matcher after execution. |
ResultValidator |
expectReturnValue(Object expectedReturnValue)
Expect the command handler to return the given expectedReturnValue after execution. |
ResultValidator |
expectStoredEvents(Object... expectedEvents)
Expect the given set of events to have been stored in the event store. |
ResultValidator |
expectStoredEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> matcher)
Expect the list of stored event to match the given matcher . |
ResultValidator |
expectVoidReturnType()
Explicitly expect a void return type on the given command handler. |
Method Detail |
---|
ResultValidator expectEvents(Object... expectedEvents)
expectPublishedEvents(Object...)
and expectStoredEvents(Object...)
methods instead.
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.
expectedEvents
- The expected events, in the exact order they are expected to be dispatched and stored.
ResultValidator expectEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> matcher)
matcher
. Note that this assertion will fail if
events
were published but not saved.
Note: if no events were published or stored, the matcher receives an empty List.
matcher
- The matcher to match with the actually published events
ResultValidator expectPublishedEvents(Object... expectedEvents)
expectEvents(Object...)
instead.
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. For Application and System events, however, the
source
of the events must be equal, too.
expectedEvents
- The expected events, in the exact order they are expected to be dispatched.
ResultValidator expectPublishedEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> matcher)
matcher
. This method will only take into
account the events that have been published. Stored events that have not been published to the event bus are
ignored.
Note: if no events were published, the matcher receives an empty List.
matcher
- The matcher which validates the actual list of published events.
ResultValidator expectStoredEvents(Object... expectedEvents)
expectEvents(Object...)
instead.
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. For Application and System events, however, the
source
of the events must be equal, too.
expectedEvents
- The expected events, in the exact order they are expected to be stored.
ResultValidator expectStoredEventsMatching(org.hamcrest.Matcher<? extends Iterable<?>> matcher)
matcher
. This method will only take into account
the events that have been stored. Stored events that have not been stored in the event store are ignored.
Note: if no events were stored, the matcher receives an empty List.
matcher
- The matcher which validates the actual list of stored events.
ResultValidator expectReturnValue(Object expectedReturnValue)
expectedReturnValue
after execution. The actual and
expected values are compared using their equals methods.
expectedReturnValue
- The expected return value of the command execution
ResultValidator expectReturnValue(org.hamcrest.Matcher<?> matcher)
matcher
after execution.
matcher
- The matcher to verify the actual return value against
ResultValidator expectException(Class<? extends Throwable> expectedException)
expectedException
to occur during command handler execution. The actual exception
should be exactly of that type, subclasses are not accepted.
expectedException
- The type of exception expected from the command handler execution
ResultValidator expectException(org.hamcrest.Matcher<?> matcher)
matcher
.
matcher
- The matcher to validate the actual exception
ResultValidator expectVoidReturnType()
void
return type on the given command handler. void
is the
recommended return value for all command handlers as they allow for a more scalable architecture.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |