execute.java

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

package org.speedframework.engine;

import java.sql.*;
import java.util.*;

import org.speedframework.exception.SpeedException;

/**
 * <p>
 * Title: SpeedFrameworkWork持久层框架
 * </p>
 * 
 * <p>
 * Description: 数据访问持久层执行接口
 * </p>
 * 
 * <p>
 * Copyright: Copyright (c) 2006
 * </p>
 * 
 * <p>
 * Company: SpeedFrameworkWork team
 * </p>
 * 
 * @author 李志峰 电话：[phone] 程伟杰 电话：
 * @version 1.0
 */
public interface Execute {

	/**
	 * <B>持久层删除方法</B>
	 * 
	 * @version 1.1Released
	 * @param con
	 *            Connection 连接，需要事务
	 * @param SQL
	 *            String sql语句
	 * @param param
	 *            String[] 参数，与sql语句'?'位置对应
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 */
	public void delete( String SQL, Object[] param,
			boolean useCache) throws SpeedException;

	/**
	 * <B>持久层删除方法</B>
	 * 
	 * @version 1.0beta
	 * @param con
	 *            Connection 连接，需要事务
	 * @param SQL
	 *            String sql语句
	 * @param entity
	 *            Object 参数，javabean
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 */
	public void delete( String SQL, Object entity,
			boolean useCache) throws SpeedException;

	/**
	 * <B>持久层插入方法</B>
	 * 
	 * @version 1.1Released
	 * @param con
	 *            Connection 连接，需要事务
	 * @param SQL
	 *            String sql语句
	 * @param param
	 *            String[]参数，与sql语句'?'位置对应
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return List
	 */
	public List insert(String SQL, Object[] param,
			boolean useCache) throws SpeedException;

	/**
	 * <B>持久层插入方法</B>
	 * 
	 * @version 1.0beta
	 * @param con
	 *            Connection 连接
	 * @param SQL
	 *            String sql字符串
	 * @param entity
	 *            Object 插入对象,javabean
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return List
	 */
	public List insert( String SQL, Object entity,
			boolean useCache) throws SpeedException;

	/**
	 * <B>持久层列表方法</B>
	 * 
	 * @version 1.1Released
	 * @param con
	 *            Connection 连接
	 * @param SQL
	 *            String sql语句
	 * @param parmvalue
	 *            String[] 参数，与sql语句'?'位置对应
	 * @param voclass
	 *            Class 承载值对象，如为null直接返回HashMap承载
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return List
	 */
	public List select( String SQL, Object[] parmvalue,
			Class voclass, boolean useCache) throws SpeedException;

	/**
	 * <B>持久层列表方法</B>
	 * 
	 * @version 1.0beta
	 * @param con
	 *            Connection 连接
	 * @param SQL
	 *            String sql语句
	 * @param entity
	 *            Object 参数，javabean
	 * @param voclass
	 *            Class 承载值对象，如为null直接返回HashMap承载
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return List
	 */
	public List select( String SQL, Object entity,
			Class voclass, boolean useCache) throws SpeedException;

	/**
	 * <B>持久层更新方法</B>
	 * 
	 * @version 1.1Released
	 * @param con
	 *            Connection 连接，需要事务
	 * @param SQL
	 *            String sql语句
	 * @param param
	 *            String[]参数，与sql语句'?'位置对应
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 */
	public void update( String SQL, Object[] param,
			boolean useCache) throws SpeedException;

	/**
	 * <B>持久层更新方法</B>
	 * 
	 * @version 1.0beta
	 * @param con
	 *            Connection 连接，需要事务
	 * @param SQL
	 *            String sql语句
	 * @param entity
	 *            Object 参数，javabean
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 */
	public void update( String SQL, Object entity,
			boolean useCache) throws SpeedException;

	/**
	 * 批处理接口
	 * 
	 * @param con
	 *            Connection
	 * @param SQL
	 *            String
	 * @param params
	 *            List 承载javabean对象
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 */
	public void executeBatch( String SQL, Object[][] params,
			boolean useCache) throws SpeedException;

	/**
	 * 批处理接口
	 * 
	 * @param con
	 *            Connection
	 * @param SQL
	 *            String
	 * @param list
	 *            String[][]
	 * @throws SpeedException
	 */
	public void executeBatch( String SQL, List list)
			throws SpeedException;

	/**
	 * 统计总记录数
	 * 
	 * @param con
	 *            Connection
	 * @param SQL
	 *            String
	 * @param params
	 *            String[]
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return int
	 */
	public int getDataCount( String SQL, Object[] params,
			boolean useCache) throws SpeedException;

	/**
	 * 存储过程
	 * 
	 * @param con
	 *            Connection
	 * @param SQL
	 *            String
	 * @param params
	 *            Object[]
	 * @param voclass
	 *            Class
	 * @param useCache
	 *            boolean
	 * @throws SpeedException
	 * @return List
	 */
	public List executeCall( String SQL, Object[] params,
			Class voclass, boolean useCache) throws SpeedException;
	
	
	
	/**
	 * 存储函数
	 * @param con
	 * @param SQL
	 * @param params
	 * @param returnType
	 * @param voclass
	 * @param useCache
	 * @return
	 * @throws SpeedException
	 */
	public Object executeFunction( String SQL, Object[] params,int returnType,
			Class voclass, boolean useCache) throws SpeedException;
	
	/**
	 * @param con
	 * @param SQL
	 * @param voclass
	 * @param useCache
	 * @return
	 * @throws SpeedException
	 */
	public List select( String SQL, Class voclass,
			boolean useCache) throws SpeedException;

}