/*
 * ClienteDAO.java
 * Created on 26/06/2004
 */
package br.com.ufskart.dao;

import java.util.Collection;

import br.com.ufskart.Cliente;
import br.com.ufskart.UfsKartException;
import br.com.ufskart.UfsKartObjectNotFoundException;
import br.com.ufskart.dao.hibernate.DAOBase;

import net.sf.hibernate.HibernateException;
import net.sf.hibernate.expression.MatchMode;


/**
 * Defini a implementao do DAO de Cliente.
 */
public interface ClienteDAO extends DAOBase {
		
	/**
	 * Obtm um cliente pelo identificador interno;
	 * @param id identificador interno.
	 * 
	 * @return cliente encontrado.
	 * 
	 * @throws UfsKartObjectNotFoundException caso no encontra o cliente.
	 * @throws HibernateException caso ocorra algum erro de infra.
	 */
	public Cliente findById(Long id) throws UfsKartObjectNotFoundException,
			UfsKartException;

	/**
	 * Obtm todos os clientes. 
	 * @return clientes encontrados.
	 * 
	 * @throws HibernateException caso ocorra algum erro de infra.
	 */
	public Collection findAll() throws UfsKartException;	
	
	/**
	 * Obtm uma lista de clientes pelo nome.
	 * @param nome nome do cliente.
	 * @param mode tipo da consulta like.
	 * 
	 * @return coleo com os clientes encontrados.
	 * 
	 * @throws HibernateException caso ocorra algum problema de infra.
	 */
	public Collection findClientesPorNome(String nome, MatchMode mode)
			throws UfsKartException;
}