Package diegosneves.github.conectardoacoes.adapters.rest.service.impl

Class AddressEntityServiceImpl

java.lang.Object

diegosneves.github.conectardoacoes.adapters.rest.service.impl.AddressEntityServiceImpl

All Implemented Interfaces:

AddressEntityService

@Service
public class AddressEntityServiceImpl
extends Object
implements AddressEntityService

A classe AddressEntityServiceImpl é responsável por fornecer serviços relacionados ao endereço. Isso compreende a criação e armazenamento de um objeto endereço. Para o armazenamento é utilizado um repositório de endereços injetado no serviço como dependência.

Ao iniciar, o serviço valida se o objeto endereço não é nulo nem vazio. Em caso de falha na validação, é lançada uma exceção AddressEntityFailuresException com a mensagem específica.

Depois, é criada uma nova instância de Address usando AddressServiceContract, que pode gerar exceções durante a criação, as quais são capturadas e tratadas, emitindo novas AddressEntityFailuresException em caso de erros.

Por fim, o serviço faz uso do objeto Address criado para armazená-lo no repositório correspondente, e retorna o objeto armazenado.

A classe oferece dois métodos principais:

1. createAndSaveAddressFromDto que cria um endereço a partir de um DTO e o salva no repositório.
2. mapAddressAndSaveToRepository que trata do mapeamento do objeto endereço para a entidade correspondente e posterior armazenamento no repositório.

Implementa a interface AddressEntityService.

Since:

1.1.0

Author:

diegoneves

Field Summary

Fields

Modifier and Type	Field	Description
static final Integer	ADDRESS_CREATION_ERROR
static final String	ADDRESS_MAPPING_ERROR_LOG
static final String	ADDRESS_REGISTRATION_SUCCESS_LOG
private final RetrieveAddressAdapter	addressAdapter
private final AddressServiceContract	addressServiceContract
static final String	CREATION_FAILURE_LOG
static final Integer	ERROR_MAPPING_ADDRESS
private final AddressRepository	repository
static final int	ZIPCODE_INVALID_FAILURE

Constructor Summary

Constructors

Constructor	Description
AddressEntityServiceImpl(AddressRepository repository, RetrieveAddressAdapter addressAdapter)

Method Summary

Modifier and Type	Method	Description
Address	createAndSaveAddressFromDto(AddressDTO address)	Cria e salva uma entidade de endereço Address com base nas informações fornecidas no DTO de Endereço AddressDTO.
private void	mapAddressAndSaveToRepository(Address address)	Este método é responsável por mapear um objeto de endereço para a entidade relevante e salvá-lo no repositório.
AddressApiResponseDTO	restrieveAddress(String zipcode)	Recupera um endereço usando o CEP fornecido.

Methods inherited from class java.lang.Object

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

Field Details

ADDRESS_CREATION_ERROR

public static final Integer ADDRESS_CREATION_ERROR

ERROR_MAPPING_ADDRESS

public static final Integer ERROR_MAPPING_ADDRESS

CREATION_FAILURE_LOG

public static final String CREATION_FAILURE_LOG

See Also:

• Constant Field Values

ADDRESS_MAPPING_ERROR_LOG

public static final String ADDRESS_MAPPING_ERROR_LOG

See Also:

• Constant Field Values

ADDRESS_REGISTRATION_SUCCESS_LOG

public static final String ADDRESS_REGISTRATION_SUCCESS_LOG

See Also:

• Constant Field Values

ZIPCODE_INVALID_FAILURE

public static final int ZIPCODE_INVALID_FAILURE

See Also:

• Constant Field Values

repository

private final AddressRepository repository

addressServiceContract

private final AddressServiceContract addressServiceContract

addressAdapter

private final RetrieveAddressAdapter addressAdapter

Constructor Details

AddressEntityServiceImpl

public AddressEntityServiceImpl(AddressRepository repository,
 RetrieveAddressAdapter addressAdapter)

Method Details

createAndSaveAddressFromDto

public Address createAndSaveAddressFromDto(AddressDTO address)
                                    throws AddressEntityFailuresException

Description copied from interface: AddressEntityService

Cria e salva uma entidade de endereço Address com base nas informações fornecidas no DTO de Endereço AddressDTO.

Este método recebe um objeto AddressDTO, que contém as informações de endereço, e retorna um objeto Address, que representa a entidade de endereço criada e salva.

O processamento inclui a conversão do DTO de endereço em uma entidade de endereço, validando as informações e salvando a entidade na base de dados. Em caso de falha na criação da entidade de endereço, uma exceção AddressEntityFailuresException será lançada.

Specified by:

createAndSaveAddressFromDto in interface AddressEntityService

Parameters:

address - Um objeto AddressDTO contendo as informações do endereço para criação da entidade de endereço.

Returns:

A entidade de endereço Address criada e salva.

Throws:

AddressEntityFailuresException - Se ocorrer uma falha durante a criação da entidade de endereço.

mapAddressAndSaveToRepository

private void mapAddressAndSaveToRepository(Address address)
                                    throws AddressEntityFailuresException

Este método é responsável por mapear um objeto de endereço para a entidade relevante e salvá-lo no repositório. Usa o BuilderMapper para mapear o endereço, depois salva no repositório.

Parameters:

address - - Um objeto de endereço que precisa ser mapeado e salvo.

Throws:

AddressEntityFailuresException - - Se ocorrer uma exceção durante o mapeamento, será lançada uma AddressEntityFailuresException. A exceção original será anexada como causa.

restrieveAddress

public AddressApiResponseDTO restrieveAddress(String zipcode)

Description copied from interface: AddressEntityService

Recupera um endereço usando o CEP fornecido.

Este método tem como objetivo fazer uma requisição para recuperar um endereço através de um CEP fornecido como parâmetro, retornando um objeto AddressApiResponseDTO contendo os detalhes do endereço.

O método interage com um serviço RetrieveAddressAdapter para realizar a requisição e obter a resposta correspondente. Após obter a resposta, a mesma é convertida para AddressApiResponseDTO e retorna ao chamador. Em caso de falha na recuperação do endereço, como por exemplo CEP nulo ou vazio, uma exceção AddressEntityFailuresException será lançada.

Specified by:

restrieveAddress in interface AddressEntityService

Parameters:

zipcode - Um String que representa o CEP para o qual o endereço precisa ser recuperado.

Returns:

Um objeto AddressApiResponseDTO que representa o endereço recuperado do CEP fornecido.