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

Class DonorDepositServiceImpl

java.lang.Object

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

All Implemented Interfaces:

DonorDepositService

@Service
public class DonorDepositServiceImpl
extends Object
implements DonorDepositService

Implementação do serviço de depósitos de doadores.

Esta classe fornece a implementação dos métodos definidos na interface DonorDepositService, responsável por gerenciar depósitos feitos por doadores.

A classe utiliza os repositórios DonorDepositRepository e DepositEntityService para persistência e operações relacionadas aos depósitos.

Constantes de Erro

• DONOR_EMAIL_NOT_FOUND_ERROR_MESSAGE - Código de erro para e-mail de doador não encontrado.
• DEPOSIT_VALIDATION_ERROR - Código de erro para falha na validação de depósito.
• REQUIRED_USER_ERROR_MESSAGE - Código de erro para usuário obrigatório.

Também utiliza o utilitário ValidationUtils para validações comuns.

Exemplo de Uso

 
 @Autowired
 private DonorDepositServiceImpl donorDepositService;

 DepositDonationRequest request = new DepositDonationRequest();
 // configuração do request
 RegisteredDepositResponse response = donorDepositService.registerDonation(request);
 
 

Since:

1.3.0

Author:

diegoneves

See Also:

• DonorDepositService
• ValidationUtils

Field Summary

Fields

Modifier and Type	Field	Description
static final Integer	DEPOSIT_VALIDATION_ERROR
private final DepositEntityService	depositEntityService
static final Integer	DONOR_EMAIL_NOT_FOUND_ERROR_MESSAGE
private final DonorDepositRepository	donorDepositRepository
static final Integer	REQUIRED_USER_ERROR_MESSAGE

Constructor Summary

Constructors

Constructor	Description
DonorDepositServiceImpl(DonorDepositRepository donorDepositRepository, DepositEntityService depositEntityService)

Method Summary

Modifier and Type	Method	Description
private static RegisteredDepositResponseFromDonorDepositMapper	getResponseMapper()	Obtém uma instância de RegisteredDepositResponseFromDonorDepositMapper que é utilizada para mapear objetos do tipo DonorDeposit para o tipo RegisteredDepositResponse.
void	linkDepositToDonor(UserEntity user)	Vincula depósitos a um doador baseado nas informações do usuário fornecidas.
private List<DepositEntity>	mergeDeposits(DepositDonationRequest request, DonorDeposit donorDeposit)	Combina os depósitos existentes de um doador com novos depósitos fornecidos em uma solicitação de doação.
RegisteredDepositResponse	registerDonation(DepositDonationRequest request)	Registra uma nova doação com base nas informações fornecidas no DepositDonationRequest.
private static void	registerDonationValidate(DepositDonationRequest request)	Valida uma solicitação de depósito.

Methods inherited from class java.lang.Object

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

Field Details

DONOR_EMAIL_NOT_FOUND_ERROR_MESSAGE

public static final Integer DONOR_EMAIL_NOT_FOUND_ERROR_MESSAGE

DEPOSIT_VALIDATION_ERROR

public static final Integer DEPOSIT_VALIDATION_ERROR

REQUIRED_USER_ERROR_MESSAGE

public static final Integer REQUIRED_USER_ERROR_MESSAGE

donorDepositRepository

private final DonorDepositRepository donorDepositRepository

depositEntityService

private final DepositEntityService depositEntityService

Constructor Details

DonorDepositServiceImpl

public DonorDepositServiceImpl(DonorDepositRepository donorDepositRepository,
 DepositEntityService depositEntityService)

Method Details

registerDonation

public RegisteredDepositResponse registerDonation(DepositDonationRequest request)

Description copied from interface: DonorDepositService

Registra uma nova doação com base nas informações fornecidas no DepositDonationRequest.

Este método é responsável por processar uma solicitação de doação de depósito, validar os dados da solicitação e registrar a doação no sistema. Ele retorna um RegisteredDepositResponse contendo as informações da doação registrada, como confirmação de que a doação foi processada com sucesso.

Specified by:

registerDonation in interface DonorDepositService

Parameters:

request - O objeto DepositDonationRequest contendo os detalhes da doação a ser registrada. Deve incluir o email do responsável pela doação e uma lista de detalhes dos depósitos (DepositDTO).

Returns:

Um objeto RegisteredDepositResponse contendo os detalhes da doação registrada, incluindo o nome do usuário, email e a lista de depósitos associados.

registerDonationValidate

private static void registerDonationValidate(DepositDonationRequest request)

Valida uma solicitação de depósito.

Este método verifica se a solicitação de depósito de doação, o e-mail do responsável pelo depósito, e a lista de objetos de depósito não são nulos ou vazios, lançando exceções em casos de validação falha.

Todas as validações utilizam o utilitário ValidationUtils para garantir que os dados obrigatórios estejam presentes antes de prosseguir com o processamento de depósito.

Parameters:

request - A solicitação de depósito que está sendo validada. O objeto DepositDonationRequest deve incluir um e-mail do responsável e uma lista de objetos do tipo DepositDTO.

Throws:

DepositProcessingException - Se qualquer um dos seguintes critérios de validação falhar:

• A solicitação de depósito (request) é nula ou está vazia.
• O e-mail do responsável pela doação (request.getResponsibleEmail()) é nulo ou está vazio.
• A lista de objetos de depósito (request.getDepositDTOS()) é nula ou está vazia.

See Also:

• ValidationUtils.validateNotNullOrEmpty(Object, String, Class)
• ValidationUtils.ensureListIsNotNullOrEmpty(List, String, Class)

getResponseMapper

private static RegisteredDepositResponseFromDonorDepositMapper getResponseMapper()

Obtém uma instância de RegisteredDepositResponseFromDonorDepositMapper que é utilizada para mapear objetos do tipo DonorDeposit para o tipo RegisteredDepositResponse.

Returns:

Uma nova instância de RegisteredDepositResponseFromDonorDepositMapper, que será usada para realizar o mapeamento dos dados de doações de doadores registrados.

mergeDeposits

private List<DepositEntity> mergeDeposits(DepositDonationRequest request,
 DonorDeposit donorDeposit)

Combina os depósitos existentes de um doador com novos depósitos fornecidos em uma solicitação de doação.

Este método une a lista de DepositEntity existente associada a um DonorDeposit com uma nova lista de DepositEntity que é criada a partir do DepositDonationRequest.

Parameters:

request - A solicitação de doação contendo detalhes dos novos depósitos. O objeto DepositDonationRequest deve incluir uma lista de DepositDTO. DepositDonationRequest#getDepositDTOS() é utilizada para obter esta lista.

donorDeposit - A entidade DonorDeposit existente associada ao doador. DonorDeposit#getDeposits() deve retornar a lista atual de depósitos do doador.

Returns:

Uma lista combinada de DepositEntity contendo os depósitos existentes e os novos.

linkDepositToDonor

public void linkDepositToDonor(UserEntity user)

Description copied from interface: DonorDepositService

Vincula depósitos a um doador baseado nas informações do usuário fornecidas.

Este método valida o usuário dado e, se o perfil do usuário for do tipo "DONOR", cria um novo registro de depósito doador e salva no repositório apropriado.

Specified by:

linkDepositToDonor in interface DonorDepositService

Parameters:

user - Um objeto UserEntity que representa o usuário cujos depósitos serão vinculados. O usuário deve ter um perfil do tipo "DONOR" para prosseguir com o vinculo.