org.seedstack.business.assembler

Interface Assembler<A,D>

Type Parameters:

A - the aggregate root

D - the dto type

All Known Implementing Classes:

AbstractBaseAssembler, BaseAssembler, BaseTupleAssembler

public interface Assembler<A,D>

This interface represents the Assembler pattern.

It provides two types of transformations:

• assembling data from one or multiple aggregates into a representation of the model or a part of the model.
• merging data from a DTO into one or multiple aggregates

See Also:

FluentAssembler

Method Summary

Modifier and Type	Method and Description
D	assembleDtoFromAggregate(A sourceAggregate) Creates a new DTO and assemble it from the aggregate.
void	assembleDtoFromAggregate(D targetDto, A sourceAggregate) Updates an existing DTO with a source aggregate root.
Class<D>	getDtoClass() Returns the DTO type handled by the assembler.
void	mergeAggregateWithDto(A targetAggregate, D sourceDto) Merges a source DTO into an existing aggregate root.

Method Detail

assembleDtoFromAggregate

D assembleDtoFromAggregate(A sourceAggregate)

Creates a new DTO and assemble it from the aggregate.

Equivalent of assembleDtoFromAggregate(new D(), sourceAggregate)

Parameters:

sourceAggregate - The source aggregate

Returns:

the resulting dto

assembleDtoFromAggregate

void assembleDtoFromAggregate(D targetDto,
                              A sourceAggregate)

Updates an existing DTO with a source aggregate root.

Parameters:

targetDto - The target dto

sourceAggregate - The source aggregate

mergeAggregateWithDto

void mergeAggregateWithDto(A targetAggregate,
                           D sourceDto)

Merges a source DTO into an existing aggregate root.

Parameters:

targetAggregate - The target aggregate

sourceDto - The source dto

getDtoClass

Class<D> getDtoClass()

Returns the DTO type handled by the assembler.

This method is used by assembleDtoFromAggregate(Object) to determine the DTO type to instantiate.

Returns:

the dto class