Package org.praxisplatform.uischema.service.base

Class AbstractBaseCrudService<E,D,ID,FD extends GenericFilterDTO>

java.lang.Object

org.praxisplatform.uischema.service.base.AbstractBaseCrudService<E,D,ID,FD>

Type Parameters:

E - Entity type

D - DTO type

ID - Identifier type

FD - Filter DTO type

All Implemented Interfaces:

BaseCrudService<E,D,ID,FD>

Direct Known Subclasses:

AbstractReadOnlyService

public abstract class AbstractBaseCrudService<E,D,ID,FD extends GenericFilterDTO>
extends Object
implements BaseCrudService<E,D,ID,FD>

Convenience base class that wires required components for BaseCrudService implementations and applies transactional semantics to the generic CRUD read/write flows exposed by the controllers.

Nested Class Summary

Nested classes/interfaces inherited from interface org.praxisplatform.uischema.service.base.BaseCrudService

BaseCrudService.SavedResult<ID,R>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractBaseCrudService(BaseCrudRepository<E,ID> repository, Class<E> entityClass)
protected	AbstractBaseCrudService(BaseCrudRepository<E,ID> repository, GenericSpecificationsBuilder<E> specificationsBuilder, Class<E> entityClass)

Method Summary

Modifier and Type	Method	Description
List<OptionDTO<ID>>	byIdsOptions(Collection<ID> ids)	Busca entidades pelos IDs fornecidos e as projeta para OptionDTO, preservando a ordem da coleção de entrada.
List<OptionDTO<Object>>	byIdsOptionSourceOptions(String sourceKey, Collection<Object> ids)
void	deleteAllById(Iterable<ID> ids)	Exclui todos os registros correspondentes aos IDs fornecidos.
void	deleteById(ID id)	Exclui uma entidade pelo identificador (ignora quando inexistente).
DistributionStatsResponse	distributionStats(DistributionStatsRequest<FD> request)	Executes a canonical distribution aggregate over the filtered dataset.
<R> CursorPage<R>	filterByCursorMapped(FD filter, org.springframework.data.domain.Sort sort, String after, String before, int size, Function<E,R> mapper)	Executa o filtro por cursor e projeta o conteúdo dentro do contexto do service.
<R> org.springframework.data.domain.Page<R>	filterMappedWithIncludeIds(FD filter, org.springframework.data.domain.Pageable pageable, Collection<ID> includeIds, Function<E,R> mapper)	Executa filtro com inclusão opcional de IDs e projeta o conteúdo dentro do contexto do service.
org.springframework.data.domain.Page<OptionDTO<ID>>	filterOptions(FD filter, org.springframework.data.domain.Pageable pageable)	Executa o filtro padrão e projeta cada entidade para OptionDTO usando o OptionMapper configurado.
org.springframework.data.domain.Page<OptionDTO<Object>>	filterOptionSourceOptions(String sourceKey, FD filter, String search, org.springframework.data.domain.Pageable pageable, Collection<Object> includeIds)
<R> List<R>	findAllByIdMapped(Collection<ID> ids, Function<E,R> mapper)	Recupera múltiplas entidades pelos seus identificadores e projeta o resultado dentro do contexto do service.
<R> List<R>	findAllMapped(Function<E,R> mapper)	Lista todas as entidades e projeta o resultado dentro do contexto do service.
<R> R	findByIdMapped(ID id, Function<E,R> mapper)	Recupera uma entidade pelo identificador e projeta o resultado dentro do contexto do service.
Class<E>	getEntityClass()
OptionSourceRegistry	getOptionSourceRegistry()	Retorna o registro de option-sources disponiveis para a entidade do recurso.
BaseCrudRepository<E,ID>	getRepository()
GenericSpecificationsBuilder<E>	getSpecificationsBuilder()
GroupByStatsResponse	groupByStats(GroupByStatsRequest<FD> request)	Executes a canonical group-by aggregate over the filtered dataset.
E	save(E entity)	Persiste uma nova entidade.
<R> R	saveMapped(E entity, Function<E,R> mapper)	Persiste uma entidade e projeta o resultado dentro do contexto do service.
<R> BaseCrudService.SavedResult<ID,R>	saveResultMapped(E entity, Function<E,R> mapper)	Persiste uma entidade e retorna, no mesmo boundary do service, o ID persistido e a projeção correspondente.
TimeSeriesStatsResponse	timeSeriesStats(TimeSeriesStatsRequest<FD> request)	Executes a canonical time-series aggregate over the filtered dataset.
E	update(ID id, E entity)	Atualiza uma entidade existente.
<R> R	updateMapped(ID id, E entity, Function<E,R> mapper)	Atualiza uma entidade e projeta o resultado dentro do contexto do service.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.praxisplatform.uischema.service.base.BaseCrudService

computeOptionLabel, extractId, filter, filterByCursor, filterWithIncludeIds, findAll, findAll, findAllById, findById, getDatasetVersion, getDefaultSort, getDistributionStatsSupportMode, getGroupByStatsSupportMode, getNotFoundException, getOptionMapper, getStatsFieldRegistry, getTimeSeriesStatsSupportMode, hasOptionSource, locate, mergeUpdate, resolveOptionSource

Constructor Details

AbstractBaseCrudService

protected AbstractBaseCrudService(BaseCrudRepository<E,ID> repository,
 GenericSpecificationsBuilder<E> specificationsBuilder,
 Class<E> entityClass)

AbstractBaseCrudService

protected AbstractBaseCrudService(BaseCrudRepository<E,ID> repository,
 Class<E> entityClass)

Method Details

getRepository

public BaseCrudRepository<E,ID> getRepository()

Specified by:

getRepository in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

getSpecificationsBuilder

public GenericSpecificationsBuilder<E> getSpecificationsBuilder()

Specified by:

getSpecificationsBuilder in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

getEntityClass

public Class<E> getEntityClass()

Specified by:

getEntityClass in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

getOptionSourceRegistry

public OptionSourceRegistry getOptionSourceRegistry()

Description copied from interface: BaseCrudService

Retorna o registro de option-sources disponiveis para a entidade do recurso.

Specified by:

getOptionSourceRegistry in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Returns:

registro de fontes derivadas; por padrao vazio

save

@Transactional
public E save(E entity)

Description copied from interface: BaseCrudService

Persiste uma nova entidade.

Specified by:

save in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

entity - instância a ser salva

Returns:

entidade salva (com ID)

saveMapped

@Transactional
public <R> R saveMapped(E entity,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Persiste uma entidade e projeta o resultado dentro do contexto do service.

Specified by:

saveMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

entity - instância a ser salva

mapper - função de projeção

Returns:

resultado projetado

saveResultMapped

@Transactional
public <R> BaseCrudService.SavedResult<ID,R> saveResultMapped(E entity,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Persiste uma entidade e retorna, no mesmo boundary do service, o ID persistido e a projeção correspondente.

Specified by:

saveResultMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

entity - instância a ser salva

mapper - função de projeção

Returns:

resultado contendo o ID persistido e o corpo projetado

update

@Transactional
public E update(ID id,
 E entity)

Description copied from interface: BaseCrudService

Atualiza uma entidade existente.

Specified by:

update in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

id - identificador da entidade a atualizar

entity - dados a serem mesclados e persistidos

Returns:

entidade atualizada

updateMapped

@Transactional
public <R> R updateMapped(ID id,
 E entity,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Atualiza uma entidade e projeta o resultado dentro do contexto do service.

Specified by:

updateMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

id - identificador da entidade a atualizar

entity - dados a serem mesclados e persistidos

mapper - função de projeção

Returns:

resultado projetado

deleteById

@Transactional
public void deleteById(ID id)

Description copied from interface: BaseCrudService

Exclui uma entidade pelo identificador (ignora quando inexistente).

Specified by:

deleteById in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

id - identificador da entidade a excluir

deleteAllById

@Transactional
public void deleteAllById(Iterable<ID> ids)

Description copied from interface: BaseCrudService

Exclui todos os registros correspondentes aos IDs fornecidos.

Specified by:

deleteAllById in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

ids - Coleção de identificadores a serem removidos

findByIdMapped

@Transactional(readOnly=true)
public <R> R findByIdMapped(ID id,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Recupera uma entidade pelo identificador e projeta o resultado dentro do contexto do service.

Specified by:

findByIdMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

id - identificador da entidade

mapper - função de projeção

Returns:

resultado projetado

findAllMapped

@Transactional(readOnly=true)
public <R> List<R> findAllMapped(Function<E,R> mapper)

Description copied from interface: BaseCrudService

Lista todas as entidades e projeta o resultado dentro do contexto do service.

Specified by:

findAllMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

mapper - função de projeção

Returns:

lista projetada

findAllByIdMapped

@Transactional(readOnly=true)
public <R> List<R> findAllByIdMapped(Collection<ID> ids,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Recupera múltiplas entidades pelos seus identificadores e projeta o resultado dentro do contexto do service.

Specified by:

findAllByIdMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

ids - coleção de identificadores

mapper - função de projeção

Returns:

lista projetada

filterMappedWithIncludeIds

@Transactional(readOnly=true)
public <R> org.springframework.data.domain.Page<R> filterMappedWithIncludeIds(FD filter,
 org.springframework.data.domain.Pageable pageable,
 Collection<ID> includeIds,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Executa filtro com inclusão opcional de IDs e projeta o conteúdo dentro do contexto do service.

Specified by:

filterMappedWithIncludeIds in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

filter - critérios de filtro

pageable - informações de paginação

includeIds - IDs que devem aparecer no topo da primeira página

mapper - função de projeção

Returns:

página resultante projetada

filterByCursorMapped

@Transactional(readOnly=true)
public <R> CursorPage<R> filterByCursorMapped(FD filter,
 org.springframework.data.domain.Sort sort,
 String after,
 String before,
 int size,
 Function<E,R> mapper)

Description copied from interface: BaseCrudService

Executa o filtro por cursor e projeta o conteúdo dentro do contexto do service.

Specified by:

filterByCursorMapped in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Type Parameters:

R - tipo projetado

Parameters:

filter - critérios de filtro

sort - ordenação aplicada

after - cursor para avançar

before - cursor para retroceder

size - tamanho da página

mapper - função de projeção

Returns:

página por cursor projetada

groupByStats

@Transactional(readOnly=true)
public GroupByStatsResponse groupByStats(GroupByStatsRequest<FD> request)

Description copied from interface: BaseCrudService

Executes a canonical group-by aggregate over the filtered dataset.

Specified by:

groupByStats in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

request - stats request

Returns:

group-by stats response

timeSeriesStats

@Transactional(readOnly=true)
public TimeSeriesStatsResponse timeSeriesStats(TimeSeriesStatsRequest<FD> request)

Description copied from interface: BaseCrudService

Executes a canonical time-series aggregate over the filtered dataset.

Specified by:

timeSeriesStats in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

request - stats request

Returns:

time-series stats response

distributionStats

@Transactional(readOnly=true)
public DistributionStatsResponse distributionStats(DistributionStatsRequest<FD> request)

Description copied from interface: BaseCrudService

Executes a canonical distribution aggregate over the filtered dataset.

Specified by:

distributionStats in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

request - stats request

Returns:

distribution stats response

filterOptions

@Transactional(readOnly=true)
public org.springframework.data.domain.Page<OptionDTO<ID>> filterOptions(FD filter,
 org.springframework.data.domain.Pageable pageable)

Description copied from interface: BaseCrudService

Executa o filtro padrão e projeta cada entidade para OptionDTO usando o OptionMapper configurado.

Em cenários com JPA e carregamento lazy, a expectativa é que a implementação concreta seja provida por AbstractBaseCrudService, para que a resolução do label ocorra dentro de transação.

Specified by:

filterOptions in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

filter - critérios de filtro

pageable - informações de paginação

Returns:

página de opções reduzidas

byIdsOptions

@Transactional(readOnly=true)
public List<OptionDTO<ID>> byIdsOptions(Collection<ID> ids)

Description copied from interface: BaseCrudService

Busca entidades pelos IDs fornecidos e as projeta para OptionDTO, preservando a ordem da coleção de entrada.

Em cenários com JPA e carregamento lazy, a expectativa é que a implementação concreta seja provida por AbstractBaseCrudService, para que a resolução do label ocorra dentro de transação.

Specified by:

byIdsOptions in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

Parameters:

ids - identificadores a serem buscados

Returns:

lista de opções na ordem solicitada

filterOptionSourceOptions

@Transactional(readOnly=true)
public org.springframework.data.domain.Page<OptionDTO<Object>> filterOptionSourceOptions(String sourceKey,
 FD filter,
 String search,
 org.springframework.data.domain.Pageable pageable,
 Collection<Object> includeIds)

Specified by:

filterOptionSourceOptions in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>

byIdsOptionSourceOptions

@Transactional(readOnly=true)
public List<OptionDTO<Object>> byIdsOptionSourceOptions(String sourceKey,
 Collection<Object> ids)

Specified by:

byIdsOptionSourceOptions in interface BaseCrudService<E,D,ID,FD extends GenericFilterDTO>