query.java

羽量级数据持久层开发框架

package org.speedframework.engine;

import org.speedframework.entity.Pagination;
import org.speedframework.exception.SpeedFrameworkException;

import java.util.List;

/**
 * Class Query 对象队列查询器
 * 
 * @author <a href="mailto:[e-mail]"> lizf </a>
 * @version $Revision:1.0.0, $Date: 2007-10-10 4:29:24 $
 */
public interface Query {

	/**
	 * Method setIndex
	 * 设置返回结果集开始位置
	 * @param begin
	 */
	public void setIndex(int begin); 
	/**
	 * Method setMaxResults
	 * 设置返回结果集至开始位置到结束的长度
	 * @param results
	 */
	public void setMaxResults(int results);

	/**
	 * 提取结果集
	 * 
	 * @param SQL
	 * @param params
	 * @param vo
	 * @return 结果集合
	 * @throws SpeedFrameworkException
	 */
	public List getResults(String SQL, Object[] params, Class vo)
			throws SpeedFrameworkException;

	/**
	 * 提取总记录数
	 * 
	 * @param SQL
	 * @param params
	 * @return 记录数
	 * @throws SpeedFrameworkException
	 */
	public int getMaxCount(String SQL, Object[] params)
			throws SpeedFrameworkException;

	/**
	 * 提取结果集
	 * 
	 * @param SQL
	 * @param params
	 * @param vo
	 * @param pagination
	 * @return 结果集合
	 * @throws SpeedFrameworkException
	 */
	public List getResults(String SQL, Object[] params, Class vo,
			Pagination pagination) throws SpeedFrameworkException;

	/**
	 * Method setUseCacheStatus
	 * 查询结构集合Cache开关
	 * @param useCache
	 */
	public void setUseCacheStatus(boolean useCache);

	/**
	 * Method getUseCacheStatus
	 * 
	 * @return 查询结果集合Cache开关
	 */
	public boolean getUseCacheStatus();
}