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