com.github.earchitecture.reuse.service.CrudService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of reuse-service Show documentation

The newest version!

package com.github.earchitecture.reuse.service;

import com.github.earchitecture.reuse.exception.ValidationServiceException;

import java.io.Serializable;
import java.util.List;

/**
 * Define operações de salvar, excluir, editar e listagem para entidades de crud.
 * 
 * @author Cleber Barcelos
 * @version 0.1.0
 * @param 
 *          Tipo da entidade a ser referenciada.
 * @param 
 *          Tipo do id a ser referenciado.
 */
public interface CrudService extends ListService {

  /**
   * Salva entidade com transação read only.
   * 
   * @param entity
   *          Entidade a ser persistida.
   * @return Entidade persistida.
   * @throws ValidationServiceException
   *           validações de negocio.
   */
  E saveTransactionReadOnly(E entity) throws ValidationServiceException;

  /**
   * Persiste uma lista de entidades
   * 
   * @param entities
   *          Lista de entidades a serem persistidas
   * @return Lista de entidade persistida.
   * @throws ValidationServiceException
   *           validações de negocio.
   */
  List save(Iterable entities) throws ValidationServiceException;

  /**
   * Persiste entidade.
   * 
   * @param entity
   *          Entidade a ser persistida.
   * @return Entidade persistida no banco
   * @throws ValidationServiceException
   *           validações de negocio.
   */
  E save(E entity) throws ValidationServiceException;

  /**
   * Remove objeto pelo id.
   * 
   * @param id
   *          id do objeto a ser removido.
   * @throws ValidationServiceException
   *           validações de negocio.
   */
  void delete(I id) throws ValidationServiceException;

  /**
   * Remove objeto por exemplo.
   * 
   * @param entity
   *          Objeto a ser removido.
   * @throws ValidationServiceException
   *           validações de negocio.
   */
  void deleteByExample(E entity) throws ValidationServiceException;
}