org.axonframework.extensions.mongo.eventsourcing.eventstore

Class MongoEventStorageEngine

java.lang.Object

org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

org.axonframework.eventsourcing.eventstore.BatchingEventStorageEngine

org.axonframework.extensions.mongo.eventsourcing.eventstore.MongoEventStorageEngine

All Implemented Interfaces:

org.axonframework.eventsourcing.eventstore.EventStorageEngine

public class MongoEventStorageEngine
extends org.axonframework.eventsourcing.eventstore.BatchingEventStorageEngine

EventStorageEngine implementation that uses Mongo to store and fetch events.

Since:

3.0

Author:

Rene de Waele

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MongoEventStorageEngine.Builder Builder class to instantiate a MongoEventStorageEngine.

Field Summary

Fields inherited from class org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

upcasterChain

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MongoEventStorageEngine(MongoEventStorageEngine.Builder builder) Instantiate a MongoEventStorageEngine based on the fields contained in the MongoEventStorageEngine.Builder.

Method Summary

Modifier and Type	Method and Description
protected void	appendEvents(List<? extends org.axonframework.eventhandling.EventMessage<?>> events, org.axonframework.serialization.Serializer serializer)
static MongoEventStorageEngine.Builder	builder() Instantiate a Builder to be able to create a MongoEventStorageEngine.
org.axonframework.eventhandling.TrackingToken	createHeadToken()
org.axonframework.eventhandling.TrackingToken	createTailToken()
org.axonframework.eventhandling.TrackingToken	createTokenAt(Instant dateTime)
void	ensureIndexes() Deprecated. This method is now called by the constructor instead of the dependency injection framework running the @PostConstruct. i.e. You no longer have to call it manually if you don't use a dependency injection framework.
protected List<? extends org.axonframework.eventhandling.DomainEventData<?>>	fetchDomainEvents(String aggregateIdentifier, long firstSequenceNumber, int batchSize)
protected List<? extends org.axonframework.eventhandling.TrackedEventData<?>>	fetchTrackedEvents(org.axonframework.eventhandling.TrackingToken lastToken, int batchSize)
Optional<Long>	lastSequenceNumberFor(String aggregateIdentifier)
protected Stream<? extends org.axonframework.eventhandling.DomainEventData<?>>	readSnapshotData(String aggregateIdentifier)
protected void	storeSnapshot(org.axonframework.eventhandling.DomainEventMessage<?> snapshot, org.axonframework.serialization.Serializer serializer)

Methods inherited from class org.axonframework.eventsourcing.eventstore.BatchingEventStorageEngine

batchSize, fetchForAggregateUntilEmpty, readEventData, readEventData

Methods inherited from class org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

appendEvents, getEventSerializer, getSnapshotSerializer, handlePersistenceException, readEvents, readEvents, readSnapshot, storeSnapshot

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.axonframework.eventsourcing.eventstore.EventStorageEngine

appendEvents, readEvents

Constructor Detail

MongoEventStorageEngine

protected MongoEventStorageEngine(MongoEventStorageEngine.Builder builder)

Instantiate a MongoEventStorageEngine based on the fields contained in the MongoEventStorageEngine.Builder.

Will assert that the MongoTemplate is not null, and will throw an AxonConfigurationException if any of them is null.

Parameters:

builder - the MongoEventStorageEngine.Builder used to instantiate a MongoEventStorageEngine instance

Method Detail

builder

public static MongoEventStorageEngine.Builder builder()

Instantiate a Builder to be able to create a MongoEventStorageEngine.

The following configurable fields have defaults:

• The snapshot Serializer defaults to XStreamSerializer.
• The EventUpcaster defaults to an NoOpEventUpcaster.
• The PersistenceExceptionResolver is defaulted to isDuplicateKeyException(Exception)
• The event Serializer defaults to a XStreamSerializer.
• The snapshotFilter defaults to a Predicate which returns true regardless.
• The batchSize defaults to an integer of size 100.
• The StorageStrategy defaults to a DocumentPerEventStorageStrategy.

The MongoTemplate is a hard requirement and as such should be provided.

Returns:

a Builder to be able to create a MongoEventStorageEngine

ensureIndexes

@Deprecated
public void ensureIndexes()

Deprecated. This method is now called by the constructor instead of the dependency injection framework running the @PostConstruct. i.e. You no longer have to call it manually if you don't use a dependency injection framework.

Make sure an index is created on the collection that stores domain events.

appendEvents

protected void appendEvents(List<? extends org.axonframework.eventhandling.EventMessage<?>> events,
                            org.axonframework.serialization.Serializer serializer)

Specified by:

appendEvents in class org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

storeSnapshot

protected void storeSnapshot(org.axonframework.eventhandling.DomainEventMessage<?> snapshot,
                             org.axonframework.serialization.Serializer serializer)

Specified by:

storeSnapshot in class org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

readSnapshotData

protected Stream<? extends org.axonframework.eventhandling.DomainEventData<?>> readSnapshotData(String aggregateIdentifier)

Specified by:

readSnapshotData in class org.axonframework.eventsourcing.eventstore.AbstractEventStorageEngine

fetchDomainEvents

protected List<? extends org.axonframework.eventhandling.DomainEventData<?>> fetchDomainEvents(String aggregateIdentifier,
                                                                                               long firstSequenceNumber,
                                                                                               int batchSize)

Specified by:

fetchDomainEvents in class org.axonframework.eventsourcing.eventstore.BatchingEventStorageEngine

fetchTrackedEvents

protected List<? extends org.axonframework.eventhandling.TrackedEventData<?>> fetchTrackedEvents(org.axonframework.eventhandling.TrackingToken lastToken,
                                                                                                 int batchSize)

Specified by:

fetchTrackedEvents in class org.axonframework.eventsourcing.eventstore.BatchingEventStorageEngine

lastSequenceNumberFor

public Optional<Long> lastSequenceNumberFor(@Nonnull
                                            String aggregateIdentifier)

createTailToken

public org.axonframework.eventhandling.TrackingToken createTailToken()

createHeadToken

public org.axonframework.eventhandling.TrackingToken createHeadToken()

createTokenAt

public org.axonframework.eventhandling.TrackingToken createTokenAt(@Nonnull
                                                                   Instant dateTime)