engine.java

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

package org.speedframework.engine;

import org.speedframework.exception.SpeedFrameworkException;

import java.io.Serializable;

import java.sql.Connection;

import java.util.List;

/**
 * Class Engine
 * 引擎类
 * @author <a href="mailto:[e-mail]"> lizf </a>
 * @version $Revision:1.0.0, $Date: 2007-10-10 4:17:28 $
 */
public interface Engine {

	/**
	 * Method setApplicationID
	 * 
	 * @param applicationID speed.cfg.xml connection-factory配置id
	 */
	public void setApplicationID(String applicationID);

	/**
	 * Method getDateBaseVersion
	 *
	 * @return 数据库类型或版本信息
	 * @throws SpeedFrameworkException
	 */
	public String getDateBaseVersion() throws SpeedFrameworkException;

	/**
	 * Method save
	 *
	 * @param pojo 表对象实体域 参考表对象域模型
	 * @return 执行后表对象实体域
	 * @throws SpeedFrameworkException
	 */
	public Object save(Object pojo) throws SpeedFrameworkException;

	/**
	 * Method update
	 *
	 * @param pojo 表对象实体域 参考表对象域模型
	 * @return 执行后表对象实体域
	 * @throws SpeedFrameworkException
	 */
	public Object update(Object pojo) throws SpeedFrameworkException;

	/**
	 * Method delete
	 *
	 * @param pojo 表对象实体域 参考表对象域模型
	 * @throws SpeedFrameworkException
	 */
	public void delete(Object pojo) throws SpeedFrameworkException;

	/**
	 * Method load
	 *
	 * @param pojo_class 表对象实体域Class 参考表对象域模型
	 * @param id 主键列表
	 * @return
	 * @throws SpeedFrameworkException
	 */
	public Object load(Class pojo_class, Serializable id)
			throws SpeedFrameworkException;

	/**
	 * Method getConnection
	 *
	 * @param commit 是否自动提交
	 * @return JDBC连接
	 * @throws SpeedFrameworkException
	 */
	public Connection getConnection(boolean commit)
			throws SpeedFrameworkException;

	/**
	 * Method commit
	 *
	 * @throws SpeedFrameworkException
	 */
	public void commit() throws SpeedFrameworkException;

	/**
	 * Method rollback
	 *
	 * @throws SpeedFrameworkException
	 */
	public void rollback() throws SpeedFrameworkException;

	/**
	 * Method closeEngine
	 *
	 * @throws SpeedFrameworkException
	 */
	public void closeEngine() throws SpeedFrameworkException;

	/**
	 * Method getQuery
	 *
	 * @return 对象队列查询器
	 */
	public Query getQuery();

	/**
	 * Method setUseCacheStatus
	 *
	 * @param status 缓存开关 默认true
	 */
	public void setUseCacheStatus(boolean status);

	/**
	 * Method getUseCacheStatus
	 *
	 * @return
	 */
	public boolean getUseCacheStatus();

	/**
	 * Method executeBatch
	 *
	 * @param SQL SQL串
	 * @param params 参数
	 * @throws SpeedFrameworkException
	 */
	public void executeBatch(String SQL, Object[][] params)
			throws SpeedFrameworkException;

	/**
	 * Method executeSpecialSQL
	 *
	 * @param SQL SQL串
	 * @param params 参数
	 * @throws SpeedFrameworkException
	 */
	public void executeSpecialSQL(String SQL, Object[] params)
			throws SpeedFrameworkException;

	/**
	 * Method executeProcedureCall
	 *
	 * @param SQL SQL串
	 * @param params 参数
	 * @param voclass 承载对象实体Class 详见视图对象域模型
	 * @return
	 * @throws SpeedFrameworkException
	 */
	public List executeProcedureCall(String SQL, Object[] params, Class voclass)
			throws SpeedFrameworkException;

	/**
	 * Method executeProcedureCall
	 *
	 * @param SQL SQL串
	 * @param params 参数
	 * @throws SpeedFrameworkException
	 */
	public void executeProcedureCall(String SQL, Object[] params)
			throws SpeedFrameworkException;

	/**
	 * Method executeFunctionCall
	 *
	 * @param SQL SQL串
	 * @param params  参数
	 * @param returnType 定义返回类型
	 * @return 单个对象或集合对象 集合对象通过List封装Map
	 * @throws SpeedFrameworkException
	 */
	public Object executeFunctionCall(String SQL, Object[] params,
			int returnType) throws SpeedFrameworkException;

	/**
	 * Method getSequences
	 *
	 * @param SeqName 序列名称
	 * @return 序列值
	 * @throws SpeedFrameworkException
	 */
	public String getSequences(String SeqName) throws SpeedFrameworkException;
}