genericdao.java

java网上考试系统

package com.qrsx.exam.dao;

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

/**
 * 所有业务数据的基础访问接口
 * <p>
 * 所有CRUD (创建，读取，修改和删除)基本数据的操作在这个接口中都是独立的， 并且所有的DAO都可以使用这些基本实现
 * 
 * @author galaxy
 */
public interface GenericDAO<T, ID extends Serializable> {

    /**
     * 通过ID来得到实体对象
     * 
     * @param id
     *            实体对象的标识符
     * @param lock
     *            使用的锁模式
     * @return 该主键值对应的实体对象
     */
    T findById(ID id, boolean lock);

    /**
     * 得到所有的实体对象
     * 
     * @return 所有的实体对象
     */
    List<T> findAll();

    /**
     * 根据对象的属性和属性的值来得到满足条件的实体对象
     * 
     * @param exampleInstance
     *            查询的条件
     * @return 满足条件的实体对象
     */
    List<T> findByExample(T exampleInstance);

    /**
     * 将实体对象持久化
     * 
     * @param entity
     *            需要进行持久化操作的实体对象
     * @return 持久化的实体对象
     */
    T makePersistent(T entity);

    /**
     * 将实体对象变为瞬态
     * 
     * @param entity
     *            需要转变为瞬态的实体对象
     */
    void makeTransient(T entity);
}