org.axonframework.test.aggregate

Class ResultValidatorImpl

java.lang.Object

org.axonframework.test.aggregate.ResultValidatorImpl

All Implemented Interfaces:

CommandCallback<Object,Object>, ResultValidator

public class ResultValidatorImpl
extends Object
implements ResultValidator, CommandCallback<Object,Object>

Implementation of the ResultValidator. It also acts as a CommandCallback, and registers the actual result.

Since:

0.7

Author:

Allard Buijze

Constructor Summary

Constructors

Constructor and Description
ResultValidatorImpl(List<EventMessage<?>> publishedEvents, FieldFilter fieldFilter) Initialize the ResultValidatorImpl with the given storedEvents and publishedEvents.

Method Summary

Modifier and Type	Method and Description
void	assertValidRecording() Makes sure the execution phase has finishes without any Errors ir FixtureExecutionExceptions.
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.
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.
void	onFailure(CommandMessage<?> commandMessage, Throwable cause) Invoked when command handling execution resulted in an error.
void	onSuccess(CommandMessage<?> commandMessage, Object result) Invoked when command handling execution was successful.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.axonframework.test.aggregate.ResultValidator

expectNoEvents

Constructor Detail

ResultValidatorImpl

public ResultValidatorImpl(List<EventMessage<?>> publishedEvents,
                           FieldFilter fieldFilter)

Initialize the ResultValidatorImpl with the given storedEvents and publishedEvents.

Parameters:

publishedEvents - The events that were published during command execution

fieldFilter - The filter describing which fields to include in the comparison

Method Detail

expectEvents

public ResultValidator expectEvents(Object... expectedEvents)

Description copied from interface: ResultValidator

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.

Specified by:

expectEvents in interface ResultValidator

Parameters:

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

Returns:

the current ResultValidator, for fluent interfacing

expectEventsMatching

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

Description copied from interface: ResultValidator

Expect the published events to match the given matcher.

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

Specified by:

expectEventsMatching in interface ResultValidator

Parameters:

matcher - The matcher to match with the actually published events

Returns:

the current ResultValidator, for fluent interfacing

expectSuccessfulHandlerExecution

public ResultValidator expectSuccessfulHandlerExecution()

Description copied from interface: ResultValidator

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

Specified by:

expectSuccessfulHandlerExecution in interface ResultValidator

Returns:

the current ResultValidator, for fluent interfacing

expectReturnValue

public ResultValidator expectReturnValue(Object expectedReturnValue)

Description copied from interface: ResultValidator

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

Specified by:

expectReturnValue in interface ResultValidator

Parameters:

expectedReturnValue - The expected return value of the command execution

Returns:

the current ResultValidator, for fluent interfacing

expectReturnValueMatching

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

Description copied from interface: ResultValidator

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

Specified by:

expectReturnValueMatching in interface ResultValidator

Parameters:

matcher - The matcher to verify the actual return value against

Returns:

the current ResultValidator, for fluent interfacing

expectException

public ResultValidator expectException(Class<? extends Throwable> expectedException)

Description copied from interface: ResultValidator

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

Specified by:

expectException in interface ResultValidator

Parameters:

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

Returns:

the current ResultValidator, for fluent interfacing

expectException

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

Description copied from interface: ResultValidator

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

Specified by:

expectException in interface ResultValidator

Parameters:

matcher - The matcher to validate the actual exception

Returns:

the current ResultValidator, for fluent interfacing

onSuccess

public void onSuccess(CommandMessage<?> commandMessage,
                      Object result)

Description copied from interface: CommandCallback

Invoked when command handling execution was successful.

Specified by:

onSuccess in interface CommandCallback<Object,Object>

Parameters:

commandMessage - The message that was dispatched

result - The result of the command handling execution, if any.

onFailure

public void onFailure(CommandMessage<?> commandMessage,
                      Throwable cause)

Description copied from interface: CommandCallback

Invoked when command handling execution resulted in an error.

Specified by:

onFailure in interface CommandCallback<Object,Object>

Parameters:

commandMessage - The message that was dispatched

cause - The exception raised during command handling

assertValidRecording

public void assertValidRecording()

Makes sure the execution phase has finishes without any Errors ir FixtureExecutionExceptions. If an error was recorded, it will be thrown immediately. This allow one to distinguish between failed tests, and tests in error.