package cn.myapps.base.dao;

import java.util.Collection;

import org.hibernate.SessionFactory;

import cn.myapps.base.action.ParamsTable;
import cn.myapps.core.user.action.WebUser;

public interface IBaseDAO {

	/**
	 * Get data Object
	 * @param hql
	 * @return object
	 * @see cn.myapps.base.dao.IBaseDAO#getData(java.lang.String)
	 */
	public abstract Object getData(String hql) throws Exception;

	/**
	 * Get datas collection
	 * @param hql
	 * @return collection
	 * @see cn.myapps.base.dao.IBaseDAO#getDatas(java.lang.String)
	 */
	public abstract Collection getDatas(String hql) throws Exception;

	/**
	 * Get datas collection  .
	 * @param hql
	 * @param params
	 * @return collection
	 * @see cn.myapps.base.dao.IBaseDAO#getDatas(java.lang.String,
	 *      java.lang.Object)
	 */
	public abstract Collection getDatas(String hql, ParamsTable params)
			throws Exception;

	/**
	 * Get datas collection.
	 * @param hql
	 * @param params
	 * @param page
	 * @param lines 
	 * @return collection
	 *            Get datas collection
	 * @see cn.myapps.base.dao.IBaseDAO#getDatas(java.lang.String,
	 *      java.lang.Object, int, int)
	 */
	public abstract Collection getDatas(String hql, ParamsTable params, int page,
			int lines) throws Exception;

	/**
	 * Get TotalLines
	 * @param hql
	 * @return int   
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#getTotalLines(java.lang.String)
	 */
	public abstract int getTotalLines(String hql) throws Exception;

	/**
	 * @param hql
	 * @param page
	 * @param lines
	 * @return Collection
	 *        Get datas collection.
	 * @see cn.myapps.base.dao.IBaseDAO#getDatas(java.lang.String, int, int)
	 */
	public abstract Collection getDatas(String hql, int page, int lines)
			throws Exception;

	/**
	 * @param hql
	 * @return DataPackage
	 *        Get the datapackage.
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#getDatapackage(java.lang.String)
	 */
	public abstract DataPackage getDatapackage(String hql) throws Exception;

	/**
	 * @param hql
	 * @param page 
	 * @param lines
	 * @return dataPackape
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#getDatapackage(java.lang.String, int,
	 *      int)
	 */
	public abstract DataPackage getDatapackage(String hql, int page, int lines)
			throws Exception;

	/**
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#getDatapackage(java.lang.String,
	 *      java.lang.Object)
	 */
	public abstract DataPackage getDatapackage(String hql, ParamsTable params)
			throws Exception;

	/**
	 * Get the datapackage
	 * @param hql  
	 * @param params Object
	 * @param page  int
	 * @param lines int
	 * @return datapackage
	 *  
	 * @see cn.myapps.base.dao.IBaseDAO#getDatapackage(java.lang.String,
	 *      java.lang.Object, int, int)
	 */
	public abstract DataPackage getDatapackage(String hql, ParamsTable params,
			int page, int lines) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#create(cn.myapps.base.dao.ValueObject,
	 *      cn.myapps.core.user.action.WebUser)
	 */
	public abstract void create(ValueObject vo, WebUser user) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#create(cn.myapps.base.dao.ValueObject)
	 */
	public abstract void create(ValueObject vo) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#create(java.lang.Object)
	 */
	public abstract void create(Object po) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#remove(java.lang.String)
	 */
	public abstract void remove(String id) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#update(cn.myapps.base.dao.ValueObject,
	 *      cn.myapps.core.user.action.WebUser)
	 */
	public abstract void update(ValueObject vo, WebUser user) throws Exception;

	/*
	 * (non-Javadoc)
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#update(cn.myapps.base.dao.ValueObject)
	 */
	public abstract void update(ValueObject vo) throws Exception;

	/**
	 * @see cn.myapps.base.dao.IBaseDAO#update(java.lang.Object)
	 */
	public abstract void update(Object po) throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#find(java.lang.String)
	 */
	public abstract ValueObject find(String id) throws Exception;

	/** 
	 * 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#query(cn.myapps.base.action.ParamsTable)
	 */
	public abstract DataPackage query(ParamsTable params) throws Exception;

	/**
	 * query datapackage
	 * @param params ParamsTable
	 * @param user WebUser
	 * @return  datapackage
	 */
	public abstract DataPackage query(ParamsTable params, WebUser user)
			throws Exception;

	public abstract SessionFactory buildSessionFactory() throws Exception;

	/** 
	 * 
	 * @see cn.myapps.base.dao.IBaseDAO#simpleQuery(cn.myapps.base.action.ParamsTable)
	 */
	public abstract Collection simpleQuery(ParamsTable params) throws Exception;

}