com.networknt.eventuate.common

Class AggregateRepository<T extends CommandProcessingAggregate<T,CT>,CT extends Command>

java.lang.Object

com.networknt.eventuate.common.AggregateRepository<T,CT>

Type Parameters:

T - the aggregate class, which is a subtype of CommandProcessingAggregate

CT - the aggregate's command class, a subtype of command

For example:

 public class AccountService {
   private final AggregateRepository>Account, AccountCommand> accountRepository;

   public AccountService(AggregateRepository>Account, AccountCommand> accountRepository) {
     this.accountRepository = accountRepository;
   }

   public CompletableFuture>EntityWithIdAndVersion>Account>> openAccount(BigDecimal initialBalance) {
     return accountRepository.save(new CreateAccountCommand(initialBalance));
   }
 }

public class AggregateRepository<T extends CommandProcessingAggregate<T,CT>,CT extends Command>
extends Object

A convenience class, with a reactive-style API that provides a simplified interface for creating and updating aggregates.

See Also:

CommandProcessingAggregate, Command

Constructor Summary

Constructors

Constructor and Description
AggregateRepository(Class<T> clasz, EventuateAggregateStore aggregateStore) Constructs a new AggregateRepository for the specified aggregate class and aggregate store

Method Summary

Modifier and Type	Method and Description
CompletableFuture<EntityWithMetadata<T>>	find(String entityId) Find an aggregate
CompletableFuture<EntityWithMetadata<T>>	find(String entityId, FindOptions findOptions) Find an aggregate
CompletableFuture<EntityWithMetadata<T>>	find(String entityId, Optional<FindOptions> findOptions) Find an aggregate
CompletableFuture<EntityWithIdAndVersion<T>>	save(CT cmd) Create a new Aggregate by processing a command and persisting the events
CompletableFuture<EntityWithIdAndVersion<T>>	save(CT cmd, Optional<SaveOptions> saveOptions) Create a new Aggregate by processing a command and persisting the events
void	setInterceptor(AggregateRepositoryInterceptor<T,CT> interceptor)
void	setMissingApplyEventMethodStrategy(MissingApplyEventMethodStrategy missingApplyEventMethodStrategy)
CompletableFuture<EntityWithIdAndVersion<T>>	update(String entityId, CT cmd) Update the specified aggregate by processing a command and saving events
CompletableFuture<EntityWithIdAndVersion<T>>	update(String entityId, CT cmd, Optional<UpdateOptions> updateOptions) Update the specified aggregate by processing a command and saving events
CompletableFuture<EntityWithIdAndVersion<T>>	updateWithProvidedCommand(String entityId, Function<T,Optional<CT>> commandProvider, Optional<UpdateOptions> updateOptions) Update the specified aggregate by processing a command and saving events

Methods inherited from class java.lang.Object

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

Constructor Detail

AggregateRepository

public AggregateRepository(Class<T> clasz,
                           EventuateAggregateStore aggregateStore)

Constructs a new AggregateRepository for the specified aggregate class and aggregate store

Parameters:

clasz - the class of the aggregate

aggregateStore - the aggregate store

Method Detail

setMissingApplyEventMethodStrategy

public void setMissingApplyEventMethodStrategy(MissingApplyEventMethodStrategy missingApplyEventMethodStrategy)

setInterceptor

public void setInterceptor(AggregateRepositoryInterceptor<T,CT> interceptor)

save

public CompletableFuture<EntityWithIdAndVersion<T>> save(CT cmd)

Create a new Aggregate by processing a command and persisting the events

Parameters:

cmd - the command to process

Returns:

the newly persisted aggregate

save

public CompletableFuture<EntityWithIdAndVersion<T>> save(CT cmd,
                                                         Optional<SaveOptions> saveOptions)

Create a new Aggregate by processing a command and persisting the events

Parameters:

cmd - the command to process

saveOptions - creation options

Returns:

the newly persisted aggregate

update

public CompletableFuture<EntityWithIdAndVersion<T>> update(String entityId,
                                                           CT cmd)

Update the specified aggregate by processing a command and saving events

Parameters:

entityId - the id of the aggregate to update

cmd - the command to process

Returns:

the updated and persisted aggregate

update

public CompletableFuture<EntityWithIdAndVersion<T>> update(String entityId,
                                                           CT cmd,
                                                           Optional<UpdateOptions> updateOptions)

Update the specified aggregate by processing a command and saving events

Parameters:

entityId - the id of the aggregate to update

cmd - the command to process

updateOptions - options for updating

Returns:

the updated and persisted aggregate

updateWithProvidedCommand

public CompletableFuture<EntityWithIdAndVersion<T>> updateWithProvidedCommand(String entityId,
                                                                              Function<T,Optional<CT>> commandProvider,
                                                                              Optional<UpdateOptions> updateOptions)

Update the specified aggregate by processing a command and saving events

Parameters:

entityId - the id of the aggregate to update

commandProvider - the provider of the command to process

updateOptions - options for updating

Returns:

the updated and persisted aggregate

find

public CompletableFuture<EntityWithMetadata<T>> find(String entityId)

Find an aggregate

Parameters:

entityId - the id of the aggregate to find

Returns:

the aggregate

find

public CompletableFuture<EntityWithMetadata<T>> find(String entityId,
                                                     FindOptions findOptions)

Find an aggregate

Parameters:

entityId - the id of the aggregate to find

findOptions - options for finding

Returns:

the aggregate

find

public CompletableFuture<EntityWithMetadata<T>> find(String entityId,
                                                     Optional<FindOptions> findOptions)

Find an aggregate

Parameters:

entityId - the id of the aggregate to find

findOptions - options for finding

Returns:

the aggregate