C语⾔连接Oracle数据库
⽬录
对很多C/C++程序员来说，操作Oracle数据库是⼀个技术难点，本⽂讲述采⽤freecplus开源框架操作Oracle数据库，freecplus框架是C语⾔技术⽹作者⼆⼗年的技术积累，功能强⼤，简单易⽤。
⼀、源代码说明
freecplus是⼀个Linux系统下的C/C++开源框架，源代码请前往C语⾔技术⽹(www.freecplus)下载。
本⽂介绍的是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/a⽂件中配置。
// charset：数据库的字符集，必须与数据库保持⼀致，否则会出现中⽂乱码的情况。
// autocommitopt：是否启⽤⾃动提交，0-不启⽤，1-启⽤，缺省是不启⽤。
// 返回值：0-成功，其它失败，失败的代码在中，失败的描述在ssage中。
int connecttodb(char *connstr,char *charset,int autocommitopt=0);
// 提交事务。
// 返回值：0-成功，其它失败，程序员⼀般不必关⼼返回值。
int commit();
// 回滚事务。
// 返回值：0-成功，其它失败，程序员⼀般不必关⼼返回值。
int  rollback();
// 断开与数据库的连接。
// 注意，断开与数据库的连接时，全部未提交的事务⾃动回滚。
// 返回值：0-成功，其它失败，程序员⼀般不必关⼼返回值。
int disconnect();
/
/ 执⾏SQL语句。
// 如果SQL语句不需要绑定输⼊和输出变量（⽆绑定变量、⾮查询语句），可以直接⽤此⽅法执⾏。
// 参数说明：这是⼀个可变参数，⽤法与printf函数相同。
// 返回值：0-成功，其它失败，失败的代码在中，失败的描述在ssage中，
// 如果成功的执⾏了⾮查询语句，在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);    // 构造函数，同时绑定数据库连接池。
oracle建立数据库连接~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 len);
// 绑定输出变量的地址。
// position：字段的顺序，从1开始，与SQL的结果集⼀⼀对应。
// value：输出变量的地址，如果是字符串，内存⼤⼩应该是表对应的字段长度加1。
// len：如果输出变量的数据类型是字符串，⽤len指定它的最⼤长度，建议采⽤表对应的字段长度。
// 返回值：0-成功，其它失败，程序员⼀般不必关⼼返回值。
// 注意：如果SQL语句没有改变，只需要bindout⼀次就可以了。
int bindout(unsigned int position,int    *value);
int bindout(unsigned int position,long  *value);
int bindout(unsigned int position,unsigned int  *value);
int bindout(unsigned int position,unsigned long *value);
int bindout(unsigned int position,float *value);
int bindout(unsigned int position,double *value);
int bindout(unsigned int position,char  *value,unsigned int len);
// 执⾏SQL语句。
// 返回值：0-成功，其它失败，失败的代码在中，失败的描述在ssage中。
// 如果成功的执⾏了⾮查询语句，在m_cda.rpc中保存了本次执⾏SQL影响记录的⾏数。
// 程序员必须检查execute⽅法的返回值。
int execute();
/
/ 执⾏SQL语句。
// 如果SQL语句不需要绑定输⼊和输出变量（⽆绑定变量、⾮查询语句），可以直接⽤此⽅法执⾏。
// 参数说明：这是⼀个可变参数，⽤法与printf函数相同。
// 返回值：0-成功，其它失败，失败的代码在中，失败的描述在ssage中，
// 如果成功的执⾏了⾮查询语句，在m_cda.rpc中保存了本次执⾏SQL影响记录的⾏数。
// 程序员必须检查execute⽅法的返回值。
int execute(const char *fmt,...);
// 从结果集中获取⼀条记录。
// 如果执⾏的SQL语句是查询语句，调⽤execute⽅法后，会产⽣⼀个结果集（存放在数据库的缓冲区中）。
// next⽅法从结果集中获取⼀条记录，把字段的值放⼊已绑定的输出变量中。
/
/ 返回值：0-成功，1403-结果集已⽆记录，其它-失败，失败的代码在中，失败的描述在ssage中。
// 返回失败的原因主要有两个：1）与数据库的连接已断开；2）绑定输出变量的内存太⼩。
// 每执⾏⼀次next⽅法，m_cda.rpc的值加1。
// 程序员必须检查next⽅法的返回值。
int next();
};
五、程序流程
freecplus框架把对Oracle数据库操作的SQL语句分为两种：有结果集的SQL语句和⽆结果集的SQL语句。
如果SQL语句被执⾏后，有结果集的产⽣，称为有结果集的SQL，即数据查询语⾔DQL，以select关键字，各种简单查询，连接查询等都属于DQL。
如果SQL语句被执⾏后，没有结果集的产⽣，称为⽆结果集的SQL，包括数据定义语⾔DDL（主要是create、drop和alter）和数据操纵语⾔DML（insert、update和insert）。
也可以这么说，查询的SQL语句会产⽣结果集，其它的SQL语句不会产⽣结果集。
1、⽆结果集SQL的程序的流程
这是⼀个完程的流程，在实际开发中，如果是执⾏简单的SQL语句，第6步和第7步可能不需要，如果SQL语句只执⾏⼀次，第7步和第8步之间的循环也不需要。
2、有结果集SQL的程序的流程
这是⼀个完程的流程，在实际开发中，如果是执⾏简单的查询语句，第6步、第7步和第8步可能不需要，如果结果集中最多只有⼀条记录，第10步和第11步之间的循环也不需要。
六、⽰例程序
1、创建超⼥信息表
⽰例（createtable.cpp）
/
*
*  程序名：createtable.cpp，此程序演⽰freecplus框架操作Oracle数据库（创建表）。
*  作者：C语⾔技术⽹(www.freecplus) ⽇期：20190525
*/
#include "_ooci.h"  // freecplus框架操作Oracle的头⽂件。
int main(int argc,char *argv[])
{
connection conn; // 数据库连接类
// 登录数据库，返回值：0-成功，其它-失败。
// 失败代码在conn.中，失败描述在conn.ssage中。
if (ttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.ssage); return -1;
}
sqlstatement stmt(&conn); // 操作SQL语句的对象。