package com.easyjf.web.tools;

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

/**
*
* <p>Title: 數據庫操作接口</p>
* <p>Description:EasyJWeb Tools中的添刪改查等業務引擎使用該DAO進行數據庫操作 </p>
* <p>Copyright: Copyright (c) 2006</p>
* <p>Company: EasyJF開源團隊</p>
* @author 大峽
* @version 0.1
*/
public interface IDAO {
	/**
	 * 把對象保存到持久層
	 * 
	 * @param obj
	 * @return
	 * @throws IdExistException
	 */
	boolean save(Object obj);

	/**
	 * 更新持久層中的對象
	 * 
	 * @param obj
	 * @return
	 */
	boolean update(Object obj);

	/**
	 * 刪除持久層中的對象
	 * 
	 * @param obj
	 * @return
	 */
	boolean del(Object obj);

	/**
	 * 根據類及主鍵加載對象
	 * 
	 * @param clz
	 * @param id
	 * @return
	 */
	Object get(Class clz, Serializable id);

	/**
	 * 根據類、字段名及字段值加載對象，只加載一條符合條件的對象。
	 * 
	 * @param clz
	 * @param fieldName
	 * @param value
	 * @return
	 */
	Object getBy(Class clz, String fieldName, Serializable value);

	/**
	 * 根據條件查詢對象
	 * 
	 * @param clz 類名
	 * @param scope 查詢條件
	 * @return
	 */
	List query(Class clz, String scope);

	/**
	 * 根據條件、條件參數查詢對象
	 * 
	 * @param clz 類名
	 * @param scope 查詢條件
	 * @param paras 查詢參數
	 * @return
	 */
	List query(Class clz, String scope, Collection paras);

	/**
	 * 查詢符合條件的對象，從begin開始取max條記錄
	 * 
	 * @param clz Java類
	 * @param scope 查詢條件
	 * @param paras 查詢參數
	 * @param begin 返回有效結果開始記錄數
	 * @param max  返回的最多記錄數
	 * @return
	 */
	List query(Class clz, String scope, Collection paras, int begin, int max);
	
	/**
	 * 執行sql語句，并返回一個對象,如select count(*) from tableName等
	 * @param sql sql語句
	 * @return
	 */
	Object uniqueResult(String sql);
	
	/**
	 * 根據sql語句及查詢參數執行查詢，并返回一個唯一對象，如select count(*) from tableName where filed=?
	 * @param sql
	 * @param paras
	 * @return
	 */
	Object uniqueResult(String sql,Collection paras);
	
	/**
	 * 執行任意sql語句，返回受影響的記錄數
	 * @param sql sql語句
	 * @return
	 */
	int execute(String sql); 
	/**
	 * 根據sql語句及參數執行數據庫操作，返回受影響的記錄數
	 * @param sql sql語句
	 * @param paras 參數
	 * @return
	 */
	int execute(String sql,Collection paras); // 執行任意SQL語句
}