engine.java

Speedframework--基于类型元数据的羽量级ORM.完全基于Java类型元数据和反射机制同时不需要任何对象关系映射配置文件的轻量级ORM框架,它充分利用了类型本身的信息,使用Metadata

package org.speedframework.engine;

import java.sql.Connection;
import org.speedframework.exception.SpeedException;

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

/**
 * <p>
 * Title: SpeedFrameworkWork持久层框架
 * </p>
 * 
 * <p>
 * Description: 程序主入口接口
 * </p>
 * 
 * <p>
 * Copyright: Copyright (c) 2006
 * </p>
 * 
 * <p>
 * Company: SpeedFrameworkWork team
 * </p>
 * 
 * @author 李志峰 电话：[phone] 程伟杰 电话：[phone]
 * @version 1.0
 */
public interface Engine {

	/**
	 * 保存数据
	 * 
	 * @param pojo
	 *            Object
	 * @throws SpeedException
	 * @return Object
	 */
	public Object save(Object pojo) throws SpeedException;

	/**
	 * 更新数据
	 * 
	 * @param pojo
	 *            Object
	 * @throws SpeedException
	 * @return Object
	 */
	public Object update(Object pojo) throws SpeedException;

	/**
	 * 删除数据
	 * 
	 * @param pojo
	 *            Object
	 * @throws SpeedException
	 */
	public void delete(Object pojo) throws SpeedException;

	/**
	 * 提取单条数据
	 * 
	 * @param pojo_class
	 *            Class
	 * @param id
	 *            Serializable
	 * @throws SpeedException
	 * @return Object
	 */
	public Object load(Class pojo_class, Serializable id) throws SpeedException;

	/**
	 * 提取连接
	 * 
	 * @param commit
	 *            boolean 提交状态
	 * @throws ConnectionException
	 * @return Connection
	 */
	public Connection getConnection(boolean commit) throws SpeedException;

	/**
	 * 提交
	 * 
	 * @throws ConnectionException
	 */
	public void commit() throws SpeedException;

	/**
	 * 回滚
	 * 
	 * @throws ConnectionException
	 */
	public void rollback() throws SpeedException;

	/**
	 * 执行引擎关闭
	 * 
	 * @throws ConnectionException
	 */
	public void closeEngine() throws SpeedException;

	/**
	 * 提取查询引擎
	 * 
	 * @return Query
	 */
	public Query getQuery();

	/**
	 * 设置临时缓存状态 默认true
	 * 
	 * @param use
	 *            boolean
	 */
	public void setUseCacheStatus(boolean status);

	/**
	 * 提取临时缓存状态
	 * 
	 * @return boolean
	 */
	public boolean getUseCacheStatus();

	/**
	 * 批处理执行
	 * 
	 * @param SQL
	 *            String
	 * @param params
	 *            String[][]
	 * @throws ConnectionException
	 */
	public void executeBatch(String SQL, Object[][] params)
			throws SpeedException;

	/**
	 * 执行特殊的增删改语句
	 * 
	 * @param SQL
	 *            String
	 * @param parmas
	 *            Object[]
	 * @throws ConnectionException
	 */
	public void executeSpecialSQL(String SQL, Object[] params)
			throws SpeedException;

	/**
	 * 带返回执行存储过程语句
	 * 
	 * @param SQL
	 *            String
	 * @param params
	 *            Object[]
	 * @throws SpeedException
	 * @return List
	 */
	public List executeProcedureCall(String SQL, Object[] params, Class voclass)
			throws SpeedException;

	/**
	 * 不带返回执行存储过程语句
	 * 
	 * @param SQL
	 *            String
	 * @param params
	 *            Object[]
	 * @throws SpeedException
	 */
	public void executeProcedureCall(String SQL, Object[] params)
			throws SpeedException;

	
	/**
	 * 执行存储函数语句
	 * @param SQL
	 * @param params
	 * @param returnType 返回参数类型,详见java.sql.Types
	 * @return
	 * @throws SpeedException
	 */
	public Object executeFunctionCall(String SQL, Object[] params,int returnType)
			throws SpeedException;

	/**
	 * 获取oracle的序列
	 * 
	 * @param dbtype
	 * @param SeqName
	 * @return
	 * @throws SpeedException
	 */
	public String getSequences(String SeqName) throws SpeedException;

}