istatement.h

Oracle OCI 应用

/**
 * IStatement.h
 *
 * @author aizy
 * @date 2004-11-24
 */

#ifndef _DB_ISTATEMENT_H_
#define _DB_ISTATEMENT_H_

#include "IResultset.h"

namespace db {

/**
 * sql语句执行接口
 */
class IStatement {
protected:
	virtual ~IStatement(){};

public:
	/**
	 * 执行语句
	 * 如:update, insert, delete, etc.
	 *
	 * @return true 有执行结果
	 *         false 执行成功但是没有执行结果
	 * @throw SqlException 数据库访问错误时抛出该异常
	 */
	virtual bool Execute(const std::string &sql) = 0;

	/**
	 * 执行select语句
	 * 注意：该函数只负责创建IResultset，不负责对其进行释放；
	 *       调用者需要在外部进行释放，调用IResultset的Close函数
	 *       进行释放。
	 *
	 * @return IResultset
	 * @throw SqlException 数据库访问错误时抛出该异常
	 */
	virtual IResultset * ExecuteQuery(const std::string &sql) = 0;

	/**
	 * 关闭语句
	 * 注意：该函数内部需要释放IStatement实例
	 */
	virtual void Close() = 0;
};

}

#endif //_DB_ISTATEMENT_H_