basedao.java

来自「购物车系统」· Java 代码 · 共 83 行

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) ;
	
}