org.axonframework.eventsourcing

Class EventSourcedAggregate<T>

java.lang.Object

org.axonframework.messaging.Scope

org.axonframework.modelling.command.AggregateLifecycle

org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

org.axonframework.eventsourcing.EventSourcedAggregate<T>

Type Parameters:

T - The type of the aggregate root object

All Implemented Interfaces:

org.axonframework.modelling.command.Aggregate<T>, org.axonframework.modelling.command.ApplyMore

public class EventSourcedAggregate<T>
extends org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

Implementation of an Aggregate that is sourced from events that have been published by the aggregate.

Field Summary

Fields inherited from class org.axonframework.modelling.command.inspection.AnnotatedAggregate

inspector

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EventSourcedAggregate(org.axonframework.modelling.command.inspection.AggregateModel<T> model, org.axonframework.eventhandling.EventBus eventBus, org.axonframework.modelling.command.RepositoryProvider repositoryProvider, SnapshotTrigger snapshotTrigger) Creates a new EventSourcedAggregate instance based on the given model, which publishes events to the given eventBus.
protected	EventSourcedAggregate(org.axonframework.modelling.command.inspection.AggregateModel<T> model, org.axonframework.eventhandling.EventBus eventBus, SnapshotTrigger snapshotTrigger) Creates a new EventSourcedAggregate instance based on the given model, which publishes events to the given eventBus.
protected	EventSourcedAggregate(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> model, org.axonframework.eventhandling.EventBus eventBus, org.axonframework.modelling.command.RepositoryProvider repositoryProvider, SnapshotTrigger snapshotTrigger) Initializes an Aggregate instance for the given aggregateRoot, based on the given model, which publishes events to the given eventBus.
protected	EventSourcedAggregate(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> model, org.axonframework.eventhandling.EventBus eventBus, SnapshotTrigger snapshotTrigger) Initializes an Aggregate instance for the given aggregateRoot, based on the given model, which publishes events to the given eventBus.

Method Summary

Modifier and Type	Method and Description
<P> org.axonframework.modelling.command.ApplyMore	doApply(P payload, org.axonframework.messaging.MetaData metaData)
protected boolean	getIsLive()
SnapshotTrigger	getSnapshotTrigger() The trigger instance that monitors this aggregate to trigger a snapshot
static <T> EventSourcedAggregate<T>	initialize(Callable<T> aggregateFactory, org.axonframework.modelling.command.inspection.AggregateModel<T> inspector, org.axonframework.eventhandling.EventBus eventBus, org.axonframework.modelling.command.RepositoryProvider repositoryProvider, SnapshotTrigger snapshotTrigger) Initializes an EventSourcedAggregate instance using the given aggregateFactory, based on the given inspector, which publishes events to the given eventBus and stores events in the given eventStore.
static <T> EventSourcedAggregate<T>	initialize(Callable<T> aggregateFactory, org.axonframework.modelling.command.inspection.AggregateModel<T> inspector, org.axonframework.eventhandling.EventBus eventBus, SnapshotTrigger snapshotTrigger) Initializes an EventSourcedAggregate instance using the given aggregateFactory, based on the given inspector, which publishes events to the given eventBus and stores events in the given eventStore.
static <T> EventSourcedAggregate<T>	initialize(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> inspector, org.axonframework.eventhandling.EventBus eventBus, org.axonframework.modelling.command.RepositoryProvider repositoryProvider, SnapshotTrigger snapshotTrigger) Initializes an EventSourcedAggregate instance for the given aggregateRoot, based on the given inspector, which publishes events to the given eventBus.
static <T> EventSourcedAggregate<T>	initialize(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> inspector, org.axonframework.eventhandling.EventBus eventBus, SnapshotTrigger snapshotTrigger) Initializes an EventSourcedAggregate instance for the given aggregateRoot, based on the given inspector, which publishes events to the given eventBus.
void	initializeState(DomainEventStream eventStream) Initialize the state of this Event Sourced Aggregate with the events from the given eventStream.
protected void	publish(org.axonframework.eventhandling.EventMessage<?> msg)
protected void	publishOnEventBus(org.axonframework.eventhandling.EventMessage<?> msg)
static <T> EventSourcedAggregate<T>	reconstruct(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> model, long seqNo, boolean isDeleted, org.axonframework.eventhandling.EventBus eventBus, org.axonframework.modelling.command.RepositoryProvider repositoryProvider, SnapshotTrigger snapshotTrigger) Reconstructs an EventSourcedAggregate instance with given aggregateRoot.
static <T> EventSourcedAggregate<T>	reconstruct(T aggregateRoot, org.axonframework.modelling.command.inspection.AggregateModel<T> model, long seqNo, boolean isDeleted, org.axonframework.eventhandling.EventBus eventBus, SnapshotTrigger snapshotTrigger) Reconstructs an EventSourcedAggregate instance with given aggregateRoot.
Long	version()

Methods inherited from class org.axonframework.modelling.command.inspection.AnnotatedAggregate

andThen, andThenApply, applyMessageOrPayload, createMessage, doCreateNew, doMarkDeleted, execute, getAggregateRoot, handle, identifier, initialize, initialize, initialize, initialize, initialize, initialize, initSequence, initSequence, invoke, isDeleted, lastSequence, registerRoot, rootType, type

Methods inherited from class org.axonframework.modelling.command.AggregateLifecycle

apply, apply, createNew, describeScope, execute, getInstance, getVersion, isLive, markDeleted

Methods inherited from class org.axonframework.messaging.Scope

describeCurrentScope, endScope, executeWithResult, getCurrentScope, startScope

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.axonframework.modelling.command.Aggregate

identifierAsString

Methods inherited from interface org.axonframework.modelling.command.ApplyMore

andThenApplyIf, andThenIf

Constructor Detail

EventSourcedAggregate

protected EventSourcedAggregate(T aggregateRoot,
                                org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                org.axonframework.eventhandling.EventBus eventBus,
                                SnapshotTrigger snapshotTrigger)

Initializes an Aggregate instance for the given aggregateRoot, based on the given model, which publishes events to the given eventBus.

Parameters:

aggregateRoot - The aggregate root instance

model - The model describing the aggregate structure

eventBus - The event store to store generated events in

snapshotTrigger - The trigger to notify of events and initialization

EventSourcedAggregate

protected EventSourcedAggregate(T aggregateRoot,
                                org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                org.axonframework.eventhandling.EventBus eventBus,
                                org.axonframework.modelling.command.RepositoryProvider repositoryProvider,
                                SnapshotTrigger snapshotTrigger)

Initializes an Aggregate instance for the given aggregateRoot, based on the given model, which publishes events to the given eventBus.

Parameters:

aggregateRoot - The aggregate root instance

model - The model describing the aggregate structure

eventBus - The event store to store generated events in

repositoryProvider - Provides repositories for specific aggregate types

snapshotTrigger - The trigger to notify of events and initialization

EventSourcedAggregate

protected EventSourcedAggregate(org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                org.axonframework.eventhandling.EventBus eventBus,
                                SnapshotTrigger snapshotTrigger)

Creates a new EventSourcedAggregate instance based on the given model, which publishes events to the given eventBus. This aggregate is not assigned a root instance yet.

Parameters:

model - The model describing the aggregate structure

eventBus - The event store to store generated events in

snapshotTrigger - The trigger to notify of events and initialization

See Also:

AnnotatedAggregate.registerRoot(Callable)

EventSourcedAggregate

protected EventSourcedAggregate(org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                org.axonframework.eventhandling.EventBus eventBus,
                                org.axonframework.modelling.command.RepositoryProvider repositoryProvider,
                                SnapshotTrigger snapshotTrigger)

Creates a new EventSourcedAggregate instance based on the given model, which publishes events to the given eventBus. This aggregate is not assigned a root instance yet.

Parameters:

model - The model describing the aggregate structure

eventBus - The event store to store generated events in

repositoryProvider - Provides repositories for specific aggregate types

snapshotTrigger - The trigger to notify of events and initialization

See Also:

AnnotatedAggregate.registerRoot(Callable)

Method Detail

initialize

public static <T> EventSourcedAggregate<T> initialize(T aggregateRoot,
                                                      org.axonframework.modelling.command.inspection.AggregateModel<T> inspector,
                                                      org.axonframework.eventhandling.EventBus eventBus,
                                                      SnapshotTrigger snapshotTrigger)

Initializes an EventSourcedAggregate instance for the given aggregateRoot, based on the given inspector, which publishes events to the given eventBus.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateRoot - The aggregate root instance

inspector - The inspector describing the aggregate structure

eventBus - The event bus to send generated events to

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the initialized EventSourcedAggregate instance

initialize

public static <T> EventSourcedAggregate<T> initialize(T aggregateRoot,
                                                      org.axonframework.modelling.command.inspection.AggregateModel<T> inspector,
                                                      org.axonframework.eventhandling.EventBus eventBus,
                                                      org.axonframework.modelling.command.RepositoryProvider repositoryProvider,
                                                      SnapshotTrigger snapshotTrigger)

Initializes an EventSourcedAggregate instance for the given aggregateRoot, based on the given inspector, which publishes events to the given eventBus.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateRoot - The aggregate root instance

inspector - The inspector describing the aggregate structure

eventBus - The event bus to send generated events to

repositoryProvider - Provides repositories for specific aggregate types

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the initialized EventSourcedAggregate instance

initialize

public static <T> EventSourcedAggregate<T> initialize(Callable<T> aggregateFactory,
                                                      org.axonframework.modelling.command.inspection.AggregateModel<T> inspector,
                                                      org.axonframework.eventhandling.EventBus eventBus,
                                                      SnapshotTrigger snapshotTrigger)
                                               throws Exception

Initializes an EventSourcedAggregate instance using the given aggregateFactory, based on the given inspector, which publishes events to the given eventBus and stores events in the given eventStore.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateFactory - The aggregate root factory

inspector - The inspector describing the aggregate structure

eventBus - The event bus to send generated events to

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the initialized EventSourcedAggregate instance

Throws:

Exception - if the aggregate cannot be initialized

initialize

public static <T> EventSourcedAggregate<T> initialize(Callable<T> aggregateFactory,
                                                      org.axonframework.modelling.command.inspection.AggregateModel<T> inspector,
                                                      org.axonframework.eventhandling.EventBus eventBus,
                                                      org.axonframework.modelling.command.RepositoryProvider repositoryProvider,
                                                      SnapshotTrigger snapshotTrigger)
                                               throws Exception

Initializes an EventSourcedAggregate instance using the given aggregateFactory, based on the given inspector, which publishes events to the given eventBus and stores events in the given eventStore.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateFactory - The aggregate root factory

inspector - The inspector describing the aggregate structure

eventBus - The event bus to send generated events to

repositoryProvider - Provides repositories for specific aggregate types

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the initialized EventSourcedAggregate instance

Throws:

Exception - if the aggregate cannot be initialized

reconstruct

public static <T> EventSourcedAggregate<T> reconstruct(T aggregateRoot,
                                                       org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                                       long seqNo,
                                                       boolean isDeleted,
                                                       org.axonframework.eventhandling.EventBus eventBus,
                                                       SnapshotTrigger snapshotTrigger)

Reconstructs an EventSourcedAggregate instance with given aggregateRoot. The aggregate's sequence number should be set to the given seqNo and its deleted flag to the given isDeleted.

Use this method to initialize an EventSourcedAggregate without having to replay the aggregate from events.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateRoot - The aggregate root instance

model - The model describing the aggregate structure

seqNo - The last event sequence number of the aggregate

isDeleted - Flag to indicate whether or not the aggregate is deleted

eventBus - The event bus to send generated events to

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the reconstructed EventSourcedAggregate instance

reconstruct

public static <T> EventSourcedAggregate<T> reconstruct(T aggregateRoot,
                                                       org.axonframework.modelling.command.inspection.AggregateModel<T> model,
                                                       long seqNo,
                                                       boolean isDeleted,
                                                       org.axonframework.eventhandling.EventBus eventBus,
                                                       org.axonframework.modelling.command.RepositoryProvider repositoryProvider,
                                                       SnapshotTrigger snapshotTrigger)

Reconstructs an EventSourcedAggregate instance with given aggregateRoot. The aggregate's sequence number should be set to the given seqNo and its deleted flag to the given isDeleted.

Use this method to initialize an EventSourcedAggregate without having to replay the aggregate from events.

Type Parameters:

T - the aggregate root type

Parameters:

aggregateRoot - The aggregate root instance

model - The model describing the aggregate structure

seqNo - The last event sequence number of the aggregate

isDeleted - Flag to indicate whether or not the aggregate is deleted

eventBus - The event bus to send generated events to

repositoryProvider - Provides repositories for specific aggregate types

snapshotTrigger - The trigger to notify of events and initialization

Returns:

the reconstructed EventSourcedAggregate instance

doApply

public <P> org.axonframework.modelling.command.ApplyMore doApply(P payload,
                                                                 org.axonframework.messaging.MetaData metaData)

Overrides:

doApply in class org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

publish

protected void publish(org.axonframework.eventhandling.EventMessage<?> msg)

Overrides:

publish in class org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

publishOnEventBus

protected void publishOnEventBus(org.axonframework.eventhandling.EventMessage<?> msg)

Overrides:

publishOnEventBus in class org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

version

public Long version()

Specified by:

version in interface org.axonframework.modelling.command.Aggregate<T>

Overrides:

version in class org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

initializeState

public void initializeState(DomainEventStream eventStream)

Initialize the state of this Event Sourced Aggregate with the events from the given eventStream.

Parameters:

eventStream - The Event Stream containing the events to be used to reconstruct this Aggregate's state.

getIsLive

protected boolean getIsLive()

Overrides:

getIsLive in class org.axonframework.modelling.command.inspection.AnnotatedAggregate<T>

getSnapshotTrigger

public SnapshotTrigger getSnapshotTrigger()

The trigger instance that monitors this aggregate to trigger a snapshot

Returns:

the trigger instance assigned to this aggregate instance