package com.ponyjava.common.hibernate3;

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

import com.ponyjava.common.page.Pagination;

public interface BaseManager<T extends Serializable> {
	/**
	 * 通過ID查找對象
	 * 
	 * @param id
	 *            記錄的ID
	 * @return 實體對象
	 */
	public T findById(Serializable id);

	public T load(Serializable id);

	/**
	 * 查找所有對象
	 * 
	 * @return 對象列表
	 */
	public List<T> findAll();

	public Pagination findAll(int pageNo, int pageSize, OrderBy... orderBys);

	/**
	 * 通過示例對象查找對象列表
	 * 
	 * @param eg
	 *            示例對象
	 * @param anyWhere
	 *            是否模糊查詢。默認false。
	 * @param conds
	 *            排序及is null。分別為OrderBy和String。
	 * @param exclude
	 *            排除屬性
	 * @return
	 */
	public List<T> findByEgList(T eg, boolean anyWhere, Condition[] conds,
			String... exclude);

	public List<T> findByEgList(T eg, boolean anyWhere, String... exclude);

	public List<T> findByEgList(T eg, Condition[] conds, String... exclude);

	public List<T> findByEgList(T eg, boolean anyWhere, Condition[] conds,
			int firstResult, int maxResult, String... exclude);

	public List<T> findByEgList(T eg, boolean anyWhere, int firstResult,
			int maxResult, String... exclude);

	public List<T> findByEgList(T eg, Condition[] conds, int firstResult,
			int maxResult, String... exclude);

	public List<T> findByEgList(T eg, String... exclude);

	public Pagination findByEg(T eg, boolean anyWhere, Condition[] conds,
			int pageNo, int pageSize, String... exclude);

	public Pagination findByEg(T eg, boolean anyWhere, int pageNo,
			int pageSize, String... exclude);

	public Pagination findByEg(T eg, Condition[] conds, int pageNo,
			int pageSize, String... exclude);

	public Pagination findByEg(T eg, int pageNo, int pageSize,
			String... exclude);

	/**
	 * 根據Updater更新對象
	 * 
	 * @param updater
	 */
	public Object updateByUpdater(Updater updater);

	public Object updateDefault(Object entity);

	/**
	 * 保存對象
	 * 
	 * @param entity
	 *            實體對象
	 * @return 操作信息
	 */
	public T save(T entity);

	public Object update(Object o);

	public Object saveOrUpdate(Object o);

	public void delete(Object o);

	/**
	 * 根據ID刪除記錄
	 * 
	 * @param id
	 *            記錄ID
	 */
	public T deleteById(Serializable id);

	/**
	 * 根據ID數組刪除記錄，當發生異常時，操作終止并回滾
	 * 
	 * @param ids
	 *            記錄ID數組
	 * @return 刪除的對象
	 */
	public List<T> deleteById(Serializable[] ids);

	/**
	 * 保存并刷新對象，避免many-to-one屬性不完整
	 * 
	 * @param entity
	 */
	public T saveAndRefresh(T entity);
}