文章目录
对很多C/C++程序员来说,操作Oracle数据库是一个技术难点,本文讲述采用freecplus开源框架操作Oracle数据库,freecplus框架是C语言技术网作者二十年的技术积累,功能强大,简单易用。
一、源代码说明
freecplus是一个Linux系统下的C/C++开源框架,源代码请前往C语言技术网(www.freecplus.net)下载。
本文介绍的是freecplus框架中采用connection和sqlstatement类操作Oracle数据库。
类的声明文件是freecplus/db/oracle/_ooci.h。
类的定义文件是freecplus/db/oracle/_ooci.cpp。
示例程序位于freecplus/db/oracle目录中。
编译规则文件是freecplus/db/oracle/makefile。
二、概述
本文不会介绍Oracle数据库、SQL语言和C/C++的基础知识,您应该是一个职业的C/C++程序员,在阅读本文之前,您已经掌握了Oracle数据库和SQL语言的基础知识。
Oracle数据库功能强大,性能卓越,无与伦比,并提供了数据访问接口OCI,OCI非常强大,强大到了普通C/C++程序员难以驾驭。
freecplus框架把OCI(Oracle Call Interface)封装成了connection和sqlstatement类,采用封装后的类操作Oracle数据库,代码简洁优雅,性能卓越。
接下来我先列出connection和sqlstatement类的声明,然后通过流程图和示例程序介绍它位的用法。
三、connection类
Oracle数据库连接池connection类的声明(程序员不必关心的私有成员和数据结构未列出):
// Oracle数据库连接池类。
class connection
{
public:
int m_state; // 与数据库的连接状态,0-未连接,1-已连接。
CDA_DEF m_cda; // 数据库操作的结果或最后一次执行SQL语句的结果。
char m_sql[10241]; // SQL语句的文本,最长不能超过10240字节。
connection(); // 构造函数。
~connection(); // 析构函数。
// 登录数据库。
// connstr:数据库的登录参数,格式:username/password@tnsname,username-用户名,password-登录密
// 码,tnsname-数据库的服务名,在$ORACLE_HOME/network/admin/tnsnames.ora文件中配置。
// charset:数据库的字符集,必须与数据库保持一致,否则会出现中文乱码的情况。
// autocommitopt:是否启用自动提交,0-不启用,1-启用,缺省是不启用。
// 返回值:0-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中。
int connecttodb(char *connstr,char *charset,int autocommitopt=0);
// 提交事务。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int commit();
// 回滚事务。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int rollback();
// 断开与数据库的连接。
// 注意,断开与数据库的连接时,全部未提交的事务自动回滚。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int disconnect();
// 执行SQL语句。
// 如果SQL语句不需要绑定输入和输出变量(无绑定变量、非查询语句),可以直接用此方法执行。
// 参数说明:这是一个可变参数,用法与printf函数相同。
// 返回值:0-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中,
// 如果成功的执行了非查询语句,在m_cda.rpc中保存了本次执行SQL影响记录的行数。
// 程序员必须检查execute方法的返回值。
// 在connection类中提供了execute方法,是为了方便程序员,在该方法中,也是用sqlstatement类来完成功能。
int execute(const char *fmt,...);
};
四、sqlstatement类
Oracle数据库的SQL语句操作sqlstatement类的声明(程序员不必关心的私有成员和数据结构未列出,对CLOB和BLOB字段操作的方法也未列出):
// 操作SQL语句类。
class sqlstatement
{
OCI_HANDLE m_handle; // SQL句柄。
connection *m_conn; // 数据库连接池指针。
int m_sqltype; // SQL语句的类型,0-查询语句;1-非查询语句。
int m_autocommitopt; // 自动提交标志,0-关闭;1-开启。
void err_report(); // 错误报告。
OCILobLocator *m_lob; // 指向LOB字段的指针。
int alloclob(); // 初始化lob指针。
int filetolob(FILE *fp); // 把文件的内容导入到clob和blob字段中。
int lobtofile(FILE *fp); // 从clob和blob字段中导出内容到文件中。
void freelob(); // 释放lob指针。
public:
int m_state; // 与数据库连接池的绑定状态,0-未绑定,1-已绑定。
char m_sql[10241]; // SQL语句的文本,最长不能超过10240字节。
CDA_DEF m_cda; // 执行SQL语句的结果。
sqlstatement(); // 构造函数。
sqlstatement(connection *conn); // 构造函数,同时绑定数据库连接池。
~sqlstatement();
// 绑定数据库连接池。
// conn:数据库连接池connection对象的地址。
// 返回值:0-成功,其它失败,只要conn参数是有效的,并且数据库的游标资源足够,connect方法不会返回失败。
// 程序员一般不必关心connect方法的返回值。
// 注意,每个sqlstatement只需要绑定一次,在绑定新的connection前,必须先调用disconnect方法。
int connect(connection *conn);
// 取消与数据库连接池的绑定。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int disconnect();
// 准备SQL语句。
// 参数说明:这是一个可变参数,用法与printf函数相同。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
// 注意:如果SQL语句没有改变,只需要prepare一次就可以了。
int prepare(const char *fmt,...);
// 绑定输入变量的地址。
// position:字段的顺序,从1开始,必须与prepare方法中的SQL的序号一一对应。
// value:输入变量的地址,如果是字符串,内存大小应该是表对应的字段长度加1。
// len:如果输入变量的数据类型是字符串,用len指定它的最大长度,建议采用表对应的字段长度。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
// 注意:如果SQL语句没有改变,只需要bindin一次就可以了。
int bindin(unsigned int position,int *value);
int bindin(unsigned int position,long *value);
int bindin(unsigned int position,unsigned int *value);
int bindin(unsigned int position,unsigned long *value);
int bindin(unsigned int position,float *value);
int bindin(unsigned int position,double *value);
int bindin(unsigned int position,char *value,unsigned int