/**
    * Copyright (c) Glodon Co. Ltd.
    */
   package gboat2.base.core.dao;
   
   import java.io.Serializable;
   import java.util.List;
   import java.util.Map;
   
  import org.hibernate.SessionFactory;
  
  /**
   * @author lysming 2011-12-6
   */
  public interface IBaseDAO {
  	
  	/**
  	 * 
  	 * 保存（持久化）一个对象
  	 * @param object 要保存的对象
  	 * @return String 对象主键
  	 */
  	public String save(Object object);
  	
  	/**
  	 * 更新一个对象
  	 * @param object 要修改的对象
  	 */
  	public void update(Object object);
  	
  	/**
  	 * 用语句更新记录
  	 * @param queryString 查询语句
  	 * @param params 参数
  	 */
  	public void updateByQuery(final String queryString, final Map<String, Object> params);
  	
  	/**
  	 * 删除一个对象
  	 * @param object	 要删除的对象
  	 */
  	public void delete(Object object);
  	
  	/**
  	 * 根据类型和对象id删除一个对象
  	 * @param clazz	类型
  	 * @param id	对象id
  	 */
  	public void delete(Class<?> clazz, Serializable id);
  	
  	/**
  	 * 根据查询和参数删除全部对象
  	 * @param queryString	查询语句
  	 * @param parameters	 参数
  	 * @return Integer
  	 */
  	public Integer deleteByQuery(final String queryString, final Map<String, Object> parameters);
  	
  	/**
  	 * 根据类型和对象id从数据库取得一个对象
  	 * 
  	 * @param clazz
  	 *            类
  	 * @param id
  	 *            对象id
  	 * @return 目标对象
  	 */
  	public Object get(Class<?> clazz, Serializable id);
  	
  	/**
  	 * 根据查询语句和查询参数从数据库取得一个对象
  	 * @param queryString	查询语句
  	 * @param params	参数
  	 * @return Object 		单个对象
  	 */
  	public Object get(String queryString, Map<String, Object> params);
  	
  	/**
  	 * 返回根据参数查询的结果的第一个符合对象
  	 * @param params 查询参数
  	 * @return Object 查询到的对象
  	 */
  	public Object get(String[][] params);
  	
  	/**
  	 * 返回根据参数查询的结果的第一个符合对象
  	 * @param params 查询参数
  	 * @return Object 查询到的对象
  	 */
  	public Object get(Map<String, Object> params);
  	
  	/**
  	 * 通用分页查询
  	 * 
  	 * @param hql hql语句
  	 * @param page	查询的页数
  	 * @param pagesize	每页条数
  	 * @param params	查询参数
  	 * @return	Page 
 	 */
 	public Page<?> getPage(String hql, int page, int pagesize, Map<String, Object> params);
 	
 	/**
 	 * 通用分页查询，自动根据queryParams中的参数生成查询
 	 * 
 	 * @param queryParams	检索条件，其中包含固定参数TABLENAME,PAGE,PAGESIZE
 	 * @return Page
 	 */
 	public Page<?> getPage(Map<String, Object> queryParams);
 	
 	/**
 	 * 通用分页查询，自动根据queryParams中的参数生成查询
 	 * 
 	 * @param queryParams 	 检索条件，其中包含固定参数TABLENAME,PAGE,PAGESIZE
 	 * @return Page
 	 */
 	public Page<?> getPage(String[][] queryParams);
 	
 	public List<?> queryListByHql(String hsql, Map<String, Object> params);
 	
 	public List<?> queryListBySql(String sql, Map<String, Object> params);
 	
 	/**
 	 * 通用列表查询
 	 * @param queryParams	查询条件
 	 * @return Page
 	 */
 	public List<?> queryList(Map<String, Object> queryParams);
 	
 	/**
 	 * 通用列表查询
 	 * @param queryParams	查询条件
 	 * @return List 结果
 	 */
 	public List<?> queryList(String[][] queryParams);
 	
 	public void addSessionFactory(SessionFactory sessionFactory);
 	public void setDefaultSessionFactory(SessionFactory sessionFactory);
 	public SessionFactory getDefaultSessionFactory();
 	
 	/**
 	 * 解除持久化：把指定的一个缓冲对象进行清除
 	 * @param object 指定的一个对象 (add by wanghb 2013-01-16)
 	 */
 	public void evict (Object object);
 	
 	/**
 	 * saveOrUpdate如果对象没有持久化标识(identifier)属性，对其调用save() ，否则update() 这个对象 ;
 	 * 如果savaOrUpdate(新po)与另一个与本session关联的po对象拥有相同的持久化标识(identifier)，抛出一个异常 
 	 * @param object 指定的一个对象 (add by wanghb 2013-01-16)
 	 */
 	public void saveOrUpdate (Object object);
 	
 	/**执行给定sql语句
 	 * @param sql
 	 * @param params
 	 * @return
 	 */
 	public int executeUpdateSql(String sql,final Map<String, Object> params);
 		
 
 	/**
 	 * @param 根据hql提供分页查询 
 	 * todo : 暂不支持传递变量参数
 	 * @param params
 	 * @return
 	 */
 	public Page<?> getPageByHql(String hql, Map<String, Object> params);
 }