package cn.hxex.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);
}