org.seedstack.business.api.interfaces.assembler

Class BaseTupleAssembler<T extends org.javatuples.Tuple,Dto>

java.lang.Object

org.seedstack.business.api.interfaces.assembler.AbstractBaseAssembler<T,Dto>

org.seedstack.business.api.interfaces.assembler.BaseTupleAssembler<T,Dto>

Type Parameters:

T - the tuple type for this assembler.

Dto - the actual dto type.

All Implemented Interfaces:

Assembler<T,Dto>

public abstract class BaseTupleAssembler<T extends org.javatuples.Tuple,Dto>
extends AbstractBaseAssembler<T,Dto>

This class is used by developers as bases for Tuple based Assemblers.

Author:

epo.jemba@ext.mpsa.com

Field Summary

Fields inherited from class org.seedstack.business.api.interfaces.assembler.AbstractBaseAssembler

dtoClass

Constructor Summary

Constructors

Constructor and Description
BaseTupleAssembler() Default needed constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Dto	assembleDtoFromAggregate(T sourceAggregate) This method is used by developers or by Assemblers to assemble a new DTO from the given aggregate.
protected abstract void	doAssembleDtoFromAggregate(Dto targetDto, T sourceAggregate) This method has to be overridden by users to actually assembling the DTO from the aggregate.
protected abstract void	doMergeAggregateWithDto(T targetAggregate, Dto sourceDto) This method has to be overridden by users to actually merge an aggregate with the DTO.
void	mergeAggregateWithDto(T targetAggregate, Dto sourceDto) This method is used by developers or by Assemblers to actually merge the aggregate.
void	updateDtoFromAggregate(Dto sourceDto, T sourceAggregate) Updates the given DTO from the aggregate.

Methods inherited from class org.seedstack.business.api.interfaces.assembler.AbstractBaseAssembler

getDtoClass, newDto

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseTupleAssembler

public BaseTupleAssembler()

Default needed constructor. Initialize internal private fields TupleType aggregateClasses.

Method Detail

assembleDtoFromAggregate

public Dto assembleDtoFromAggregate(T sourceAggregate)

This method is used by developers or by Assemblers to assemble a new DTO from the given aggregate.

• It calls AbstractBaseAssembler.newDto() for the DTO creation;
• and doAssembleDtoFromAggregate(Object, org.javatuples.Tuple) for the assembly algorithm.

Parameters:

sourceAggregate - The aggregate from which create the DTO.

Returns:

the assembled dto

See Also:

Assembler.assembleDtoFromAggregate(Object)

updateDtoFromAggregate

public void updateDtoFromAggregate(Dto sourceDto,
                          T sourceAggregate)

Description copied from interface: Assembler

Updates the given DTO from the aggregate.

Parameters:

sourceDto - The dto to update.

sourceAggregate - The aggregate to copy data from.

mergeAggregateWithDto

public void mergeAggregateWithDto(T targetAggregate,
                         Dto sourceDto)

This method is used by developers or by Assemblers to actually merge the aggregate.

It will call doMergeAggregateWithDto(org.javatuples.Tuple, Object), which is overridden by developers.

Parameters:

targetAggregate - the aggregate to merge

sourceDto - the dto to copy data from

See Also:

Assembler.mergeAggregateWithDto(Object, Object)

doAssembleDtoFromAggregate

protected abstract void doAssembleDtoFromAggregate(Dto targetDto,
                              T sourceAggregate)

This method has to be overridden by users to actually assembling the DTO from the aggregate.

 targetDto.fillProductId(sourceAggregate.getEntityId().getStoreId(),
     sourceAggregate.getEntityId().getProductCode());
 targetDto.setName(sourceAggregate.getName());
 targetDto.setDescription(sourceAggregate.getDescription());
 

This method will be called by the public method assembleDtoFromAggregate(org.javatuples.Tuple)

Parameters:

targetDto - the dto to assemble

sourceAggregate - the aggregate to copy data from

doMergeAggregateWithDto

protected abstract void doMergeAggregateWithDto(T targetAggregate,
                           Dto sourceDto)

This method has to be overridden by users to actually merge an aggregate with the DTO.

 ...
 targetAggregate.setName(sourceDto.getName());
 targetAggregate.setDescription(sourceDto.getDescription());
 ...
 

This method will be called by the public method mergeAggregateWithDto(org.javatuples.Tuple, Object)

Parameters:

targetAggregate - the aggregate to merge

sourceDto - the dto to copy data from