|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface FixtureConfiguration
Interface describing action to perform on a Saga Test Fixture during the configuration phase.
Method Summary | ||
---|---|---|
org.joda.time.DateTime |
currentTime()
Returns the time as "known" by the fixture. |
|
GivenAggregateEventPublisher |
givenAggregate(Object aggregateIdentifier)
Use this method to indicate that an aggregate with given identifier published certain events. |
|
ContinuedGivenState |
givenAPublished(Object event)
Indicates that the given applicationEvent has been published in the past. |
|
WhenState |
givenNoPriorActivity()
Indicates that no relevant activity has occurred in the past. |
|
|
registerCommandGateway(Class<T> gatewayInterface)
Creates a Command Gateway for the given gatewayInterface and registers that as a resource. |
|
|
registerCommandGateway(Class<T> gatewayInterface,
T stubImplementation)
Creates a Command Gateway for the given gatewayInterface and registers that as a resource. |
|
FixtureConfiguration |
registerFieldFilter(FieldFilter fieldFilter)
Registers the given fieldFilter , which is used to define which Fields are used when comparing
objects. |
|
FixtureConfiguration |
registerIgnoredField(Class<?> declaringClass,
String fieldName)
Indicates that a field with given fieldName , which is declared in given declaringClass
is ignored when performing deep equality checks. |
|
void |
registerResource(Object resource)
Registers the given resource . |
|
void |
setCallbackBehavior(CallbackBehavior callbackBehavior)
Sets the instance that defines the behavior of the Command Bus when a command is dispatched with a callback. |
Method Detail |
---|
void registerResource(Object resource)
resource
. When a Saga is created, all resources are injected on that instance
before any Events are passed onto it.
Note that a CommandBus, EventBus and EventScheduler are already registered as resources, and need not be
registered again.
Also note that you might need to reset the resources manually if you want to isolate behavior during the "when"
stage of the test.
resource
- the resource to register.<T> T registerCommandGateway(Class<T> gatewayInterface)
gatewayInterface
and registers that as a resource. The
gateway will dispatch commands on the Command Bus contained in this Fixture, so that you can validate commands
using FixtureExecutionResult.expectDispatchedCommandsEqualTo(Object...)
and FixtureExecutionResult.expectDispatchedCommandsMatching(org.hamcrest.Matcher)
.
Note that you need to use setCallbackBehavior(org.axonframework.test.utils.CallbackBehavior)
to defined
the behavior of commands when expecting return values. Alternatively, you can use registerCommandGateway(Class, Object)
to define behavior using a stub implementation.
T
- The gateway typegatewayInterface
- The interface describing the gateway
<T> T registerCommandGateway(Class<T> gatewayInterface, T stubImplementation)
gatewayInterface
and registers that as a resource. The
gateway will dispatch commands on the Command Bus contained in this Fixture, so that you can validate commands
using FixtureExecutionResult.expectDispatchedCommandsEqualTo(Object...)
and FixtureExecutionResult.expectDispatchedCommandsMatching(org.hamcrest.Matcher)
.
The behavior of the created gateway is defined by the given stubImplementation
, if not null.
Dispatched Commands are still recorded for verification. Note that only commands executed in the "when" phase
are recorded, while the stub implementation may record activity during the "given" phase as well.
T
- The gateway typegatewayInterface
- The interface describing the gatewaystubImplementation
- The stub or mock implementation defining behavior of the gateway
FixtureConfiguration registerFieldFilter(FieldFilter fieldFilter)
fieldFilter
, which is used to define which Fields are used when comparing
objects. The ResultValidator.expectEvents(Object...)
and ResultValidator.expectReturnValue(Object)
,
for example, use this filter.
When multiple filters are registered, a Field must be accepted by all registered filters in order to be
accepted.
By default, all Fields are included in the comparison.
fieldFilter
- The FieldFilter that defines which fields to include in the comparison
FixtureConfiguration registerIgnoredField(Class<?> declaringClass, String fieldName)
fieldName
, which is declared in given declaringClass
is ignored when performing deep equality checks.
declaringClass
- The class declaring the fieldfieldName
- The name of the field
FixtureExecutionException
- when no such field is declaredvoid setCallbackBehavior(CallbackBehavior callbackBehavior)
callbackBehavior
- The instance deciding to how the callback should be invoked.GivenAggregateEventPublisher givenAggregate(Object aggregateIdentifier)
andThenAggregate(someIdentifier).published(someEvents)
aggregateIdentifier
- The identifier of the aggregate the events should appear to come from
ContinuedGivenState givenAPublished(Object event)
applicationEvent
has been published in the past. This event is sent to the
associated sagas.
event
- The event to publish
WhenState givenNoPriorActivity()
org.joda.time.DateTime currentTime()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |