org.fuin.ddd4j.ddd

Class AbstractAggregateRoot<ID extends AggregateRootId>

java.lang.Object

org.fuin.ddd4j.ddd.AbstractAggregateRoot<ID>

Type Parameters:

ID - Aggregate identifier.

All Implemented Interfaces:

AggregateRoot<ID>, Entity<ID>

public abstract class AbstractAggregateRoot<ID extends AggregateRootId>
extends java.lang.Object
implements AggregateRoot<ID>

Base class for aggregate roots.

Constructor Summary

Constructors

Constructor and Description
AbstractAggregateRoot() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected void	apply(@NotNull DomainEvent<?> event) Applies the given new event.
boolean	equals(java.lang.Object obj)
protected java.util.List<java.lang.Class<? extends DomainEvent<?>>>	getIgnoredEvents() Returns a list of old / ignored events.
int	getNextVersion() Returns the next version of the aggregate.
java.util.List<DomainEvent<?>>	getUncommittedChanges() Returns a list of uncommitted changes.
int	getVersion() Returns the current version of the aggregate.
int	hashCode()
boolean	hasUncommitedChanges() Returns the information if the aggregate has uncommited changes.
void	loadFromHistory(DomainEvent<?>... history) Loads the aggregate with historic events.
void	loadFromHistory(java.util.List<DomainEvent<?>> history) Loads the aggregate with historic events.
void	markChangesAsCommitted() Clears the internal change list and sets the new version number.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.fuin.ddd4j.ddd.AggregateRoot

getId

Methods inherited from interface org.fuin.ddd4j.ddd.Entity

getType

Constructor Detail

AbstractAggregateRoot

public AbstractAggregateRoot()

Default constructor.

Method Detail

hashCode

public final int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public final boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getUncommittedChanges

public final java.util.List<DomainEvent<?>> getUncommittedChanges()

Description copied from interface: AggregateRoot

Returns a list of uncommitted changes.

Specified by:

getUncommittedChanges in interface AggregateRoot<ID extends AggregateRootId>

Returns:

List of events that were not persisted yet.

hasUncommitedChanges

public final boolean hasUncommitedChanges()

Description copied from interface: AggregateRoot

Returns the information if the aggregate has uncommited changes.

Specified by:

hasUncommitedChanges in interface AggregateRoot<ID extends AggregateRootId>

Returns:

TRUE if the aggregate will return a non-empty list for AggregateRoot.getUncommittedChanges(), else FALSE.

markChangesAsCommitted

public final void markChangesAsCommitted()

Description copied from interface: AggregateRoot

Clears the internal change list and sets the new version number.

Specified by:

markChangesAsCommitted in interface AggregateRoot<ID extends AggregateRootId>

getVersion

public final int getVersion()

Description copied from interface: AggregateRoot

Returns the current version of the aggregate.

Specified by:

getVersion in interface AggregateRoot<ID extends AggregateRootId>

Returns:

Current version that does NOT included uncommited changes.

getNextVersion

public final int getNextVersion()

Description copied from interface: AggregateRoot

Returns the next version of the aggregate.

Specified by:

getNextVersion in interface AggregateRoot<ID extends AggregateRootId>

Returns:

Next version that includes all currently uncommited changes.

loadFromHistory

public final void loadFromHistory(DomainEvent<?>... history)

Description copied from interface: AggregateRoot

Loads the aggregate with historic events.

Specified by:

loadFromHistory in interface AggregateRoot<ID extends AggregateRootId>

Parameters:

history - List of historic events.

loadFromHistory

public final void loadFromHistory(java.util.List<DomainEvent<?>> history)

Description copied from interface: AggregateRoot

Loads the aggregate with historic events.

Specified by:

loadFromHistory in interface AggregateRoot<ID extends AggregateRootId>

Parameters:

history - List of historic events.

getIgnoredEvents

protected final java.util.List<java.lang.Class<? extends DomainEvent<?>>> getIgnoredEvents()

Returns a list of old / ignored events. Sub classes can overwrite this method to ignore historic events that are not needed any more.

Returns:

Events that can be safely ignored.

apply

protected final void apply(@NotNull
                           @NotNull DomainEvent<?> event)

Applies the given new event. CAUTION: Don't use this method for applying historic events!

Parameters:

event - Event to dispatch to the appropriate event handler method.