org.seedstack.business.assembler

Class BaseAssembler<A extends AggregateRoot<?>,D>

java.lang.Object

org.seedstack.business.assembler.AbstractBaseAssembler<A,D>

org.seedstack.business.assembler.BaseAssembler<A,D>

Type Parameters:

A - the aggregate root type

D - the dto type

All Implemented Interfaces:

Assembler<A,D>

public abstract class BaseAssembler<A extends AggregateRoot<?>,D>
extends AbstractBaseAssembler<A,D>

This class is the class to be extended by the users in order to create an Assembler.

User must implements doAssembleDtoFromAggregate(Object, org.seedstack.business.domain.AggregateRoot) and doMergeAggregateWithDto(org.seedstack.business.domain.AggregateRoot, Object) to provide implementation of the copy.

For instance:

 public class ProductAssembler extends BaseAssembler<Product,ProductRepresentation> {

      @Override
     protected void doAssembleDtoFromAggregate(ProductRepresentation targetDto, Product sourceAggregate) {
          targetDto.fillProductId(sourceAggregate.getEntityId().getStoreId(),
              sourceAggregate.getEntityId().getProductCode());
          targetDto.setName(sourceAggregate.getName());
          targetDto.setDescription(sourceAggregate.getDescription());
     }

      @Override
     protected void doMergeAggregateWithDto(Product targetAggregate, ProductRepresentation sourceDto) {
          targetAggregate.setName(sourceDto.getName());
          targetAggregate.setDescription(sourceDto.getDescription());
     }
 }
 

Then the assembler can be used via:

  @Inject
 ProductAssembler productAssembler;
 

And used like this:

 ProductRepresentation productRepresentation = productAssembler.assembleDtoFromAggregate(productFromRepo);
 

or

 productAssembler.mergeAggregateWithDto(productToMerge, productRepresentationSource);
 

Author:

epo.jemba@ext.mpsa.com

Field Summary

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

dtoClass

Constructor Summary

Constructors

Constructor and Description
BaseAssembler()

Method Summary

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

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

getDtoClass, newDto

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseAssembler

public BaseAssembler()

Method Detail

assembleDtoFromAggregate

public D assembleDtoFromAggregate(A sourceAggregate)

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

• It calls AbstractBaseAssembler.newDto() for the DTO creation
• and doAssembleDtoFromAggregate(Object, org.seedstack.business.domain.AggregateRoot) for the assembly algorithm.

Parameters:

sourceAggregate - The aggregate from which create the DTO.

Returns:

the assembled DTO

See Also:

Assembler.assembleDtoFromAggregate(Object)

assembleDtoFromAggregate

public void assembleDtoFromAggregate(D targetDto,
                                     A sourceAggregate)

Description copied from interface: Assembler

Updates an existing DTO with a source aggregate root.

Parameters:

targetDto - The target dto

sourceAggregate - The source aggregate

doAssembleDtoFromAggregate

protected abstract void doAssembleDtoFromAggregate(D targetDto,
                                                   A sourceAggregate)

This method has to be overridden by users to actually assemble 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.seedstack.business.domain.AggregateRoot)

Parameters:

targetDto - the target dto

sourceAggregate - the source aggregate

mergeAggregateWithDto

public void mergeAggregateWithDto(A targetAggregate,
                                  D sourceDto)

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

It will call doMergeAggregateWithDto(org.seedstack.business.domain.AggregateRoot, Object), which is overridden by developers.

Parameters:

targetAggregate - the target aggregate

sourceDto - the source dto

See Also:

Assembler.mergeAggregateWithDto(Object, Object)

doMergeAggregateWithDto

protected abstract void doMergeAggregateWithDto(A targetAggregate,
                                                D 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.seedstack.business.domain.AggregateRoot, Object).

Parameters:

sourceDto - the source dto

targetAggregate - the target aggregate