package cn.com.tarena.ecport.dao;

import java.util.List;

import cn.com.tarena.ecport.pojo.BasePojo;


/**
 * <pre>
 * 所有DAO接口的父類
 * 提供了大部分DAO所需要的共通數據庫操作接口
 * 這里使用了JDK1.5的新特性，通過“泛型”來傳遞不同的POJO類型。
 * </pre>
 * 
 * @author zhouyu 2008-1-15
 *
 * @param <E> 繼承于BasePojo的Pojo
 */
public interface BaseDAO<E extends BasePojo> {

	/**
	 * 把尚未持久化的Pojo登錄至數據庫
	 * 
	 * @param transientPojo 尚未持久化的Pojo
	 */
	public void save(E transientPojo) ;
	
	/**
	 * 根據持久化的Pojo刪除數據庫中相應數據
	 * 
	 * @param persistencePojo 持久化的Pojo
	 */
	public void delete(E persistencePojo) ;
	
	/**
	 * 根據Pojo的主鍵取得數據庫中的相應數據
	 * 
	 * @param id Pojo的主鍵
	 * @return Pojo
	 */
	public E findById(Long id) ;
	
	/**
	 * 根據范例Pojo取得數據庫中的相應數據
	 * 
	 * @param ExamplePojo 范例Pojo
	 * @return Pojo的List
	 */
	public List<E> findByExample(E ExamplePojo);
	
	/**
	 * 根據Pojo的屬性名和Pojo屬性的值在數據庫中取得相應數據
	 * 
	 * @param propertyName 屬性名
	 * @param value 值
	 * @return Pojo的List
	 */
	public List<E> findByProperty(String propertyName, Object value) ;
	
	/**
	 * 合并游離的Pojo，使游離的Pojo再次變成持久化的Pojo
	 * 
	 * @param detachedPojo 游離的Pojo
	 * @return Pojo
	 */
	public E merge(E detachedPojo) ;
	
	/**
	 * 根據Pojo的狀態，進行登錄或者更新至數據庫的操作
	 * 
	 * @param pojo
	 */
	public void saveOrUpdate(E pojo) ;
	
	/**
	 * 把游離的Pojo再次變成持久化的Pojo
	 * 
	 * @param pojo
	 */
	public void lock(E pojo) ;
	
}