freecplus框架-Oracle数据库操作

一、源代码说明

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 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-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中。
  // 如果成功的执行了非查询语句,在m_cda.rpc中保存了本次执行SQL影响记录的行数。
  // 程序员必须检查execute方法的返回值。
  int execute();

  // 执行SQL语句。
  // 如果SQL语句不需要绑定输入和输出变量(无绑定变量、非查询语句),可以直接用此方法执行。
  // 参数说明:这是一个可变参数,用法与printf函数相同。
  // 返回值:0-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中,
  // 如果成功的执行了非查询语句,在m_cda.rpc中保存了本次执行SQL影响记录的行数。
  // 程序员必须检查execute方法的返回值。
  int execute(const char *fmt,...);

  // 从结果集中获取一条记录。
  // 如果执行的SQL语句是查询语句,调用execute方法后,会产生一个结果集(存放在数据库的缓冲区中)。
  // next方法从结果集中获取一条记录,把字段的值放入已绑定的输出变量中。
  // 返回值:0-成功,1403-结果集已无记录,其它-失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中。
  // 返回失败的原因主要有两个: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的程序的流程

freecplus框架-Oracle数据库操作

这是一个完程的流程,在实际开发中,如果是执行简单的SQL语句,第6步和第7步可能不需要,如果SQL语句只执行一次,第7步和第8步之间的循环也不需要。

2、有结果集SQL的程序的流程

freecplus框架-Oracle数据库操作
这是一个完程的流程,在实际开发中,如果是执行简单的查询语句,第6步、第7步和第8步可能不需要,如果结果集中最多只有一条记录,第10步和第11步之间的循环也不需要。

六、示例程序

1、创建超女信息表

示例(createtable.cpp)

/*
 *  程序名:createtable.cpp,此程序演示freecplus框架操作Oracle数据库(创建表)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  // 准备创建表的SQL语句。
  // 超女表girls,超女编号id,超女姓名name,体重weight,报名时间btime,超女说明memo,超女图片pic。
  stmt.prepare("    create table girls(id    number(10),                       name  varchar2(30),                       weight   number(8,2),                       btime date,                       memo  clob,                       pic   blob,                       primary key (id))");
  // prepare方法不需要判断返回值。

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
  if (stmt.execute() != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  printf("create table girls ok.\n");
}

运行效果

freecplus框架-Oracle数据库操作

2、向超女表中插入5条记录

示例(inserttable.cpp)

/*
 *  程序名:inserttable.cpp,此程序演示freecplus框架操作Oracle数据库(向表中插入5条记录)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

// 定义用于超女信息的结构,与表中的字段对应。
struct st_girls
{
  long id;        // 超女编号,用long数据类型对应Oracle无小数的number(10)。
  char name[11];  // 超女姓名,用char[31]对应Oracle的varchar2(30)。
  double weight;  // 超女体重,用double数据类型对应Oracle有小数的number(8,2)。
  char btime[20]; // 报名时间,用char对应Oracle的date,格式:‘yyyy-mm-dd hh24:mi:ssi‘。
} stgirls;

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  // 准备插入表的SQL语句。
  stmt.prepare("    insert into girls(id,name,weight,btime)                 values(:1,:2,:3,to_date(:4,‘yyyy-mm-dd hh24:mi:ss‘))");
  // prepare方法不需要判断返回值。
  // 为SQL语句绑定输入变量的地址,bindin方法不需要判断返回值。
  stmt.bindin(1,&stgirls.id);
  stmt.bindin(2, stgirls.name,10);
  stmt.bindin(3,&stgirls.weight);
  stmt.bindin(4, stgirls.btime,19);

  // 模拟超女数据,向表中插入5条测试信息。
  for (int ii=1;ii<=5;ii++)
  {
    memset(&stgirls,0,sizeof(stgirls)); // 结构体变量初始化。

    // 为结构体变量的成员赋值。
    stgirls.id=ii;                                 // 超女编号。
    sprintf(stgirls.name,"超女%02d",ii);           // 超女姓名。
    stgirls.weight=ii*2.11;                        // 超女体重。
    strcpy(stgirls.btime,"2018-03-01 12:25:31");   // 报名时间。

    // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
    // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
    if (stmt.execute() != 0)
    {
      printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
    }

    printf("成功插入了%ld条记录。\n",stmt.m_cda.rpc); // stmt.m_cda.rpc是本次执行SQL影响的记录数。
  }

  printf("insert table girls ok.\n");

  conn.commit(); // 提交数据库事务。
}

运行效果

freecplus框架-Oracle数据库操作

3、更新超女表中的记录

示例(updatetable.cpp)

/*
 *  程序名:updatetable.cpp,此程序演示freecplus框架操作Oracle数据库(修改表中的记录)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  char strbtime[20];  // 用于存放超女的报名时间。
  memset(strbtime,0,sizeof(strbtime));
  strcpy(strbtime,"2019-12-20 09:45:30");

  // 准备更新数据的SQL语句,不需要判断返回值。
  stmt.prepare("    update girls set btime=to_date(:1,‘yyyy-mm-dd hh24:mi:ss‘) where id>=2 and id<=4");
  // prepare方法不需要判断返回值。
  // 为SQL语句绑定输入变量的地址,bindin方法不需要判断返回值。
  stmt.bindin(1,strbtime,19);
  // 如果不采用绑定输入变量的方法,把strbtime的值直接写在SQL语句中也是可以的,如下:
  /*
  stmt.prepare("    update girls set btime=to_date(‘%s‘,‘yyyy-mm-dd hh24:mi:ss‘) where id>=2 and id<=4",strbtime);
  */

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
  if (stmt.execute() != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  // 请注意,stmt.m_cda.rpc变量非常重要,它保存了SQL被执行后影响的记录数。
  printf("本次更新了girls表%ld条记录。\n",stmt.m_cda.rpc);

  // 提交事务
  conn.commit();
}

运行效果

freecplus框架-Oracle数据库操作
4、查询超女表中的记录

示例(selecttable.cpp)

/*
 *  程序名:selecttable.cpp,此程序演示freecplus框架操作Oracle数据库(查询表中的记录)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

// 定义用于超女信息的结构,与表中的字段对应。
struct st_girls
{
  long id;        // 超女编号,用long数据类型对应Oracle无小数的number(10)。
  char name[31];  // 超女姓名,用char[31]对应Oracle的varchar2(30)。
  double weight;  // 超女体重,用double数据类型对应Oracle有小数的number(8,2)。
  char btime[20]; // 报名时间,用char对应Oracle的date,格式:‘yyyy-mm-dd hh24:mi:ss‘。
} stgirls;

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  int iminid,imaxid;  // 查询条件最小和最大的id。

  // 准备查询表的SQL语句。
  stmt.prepare("    select id,name,weight,to_char(btime,‘yyyy-mm-dd hh24:mi:ss‘) from girls where id>=:1 and id<=:2");
  // prepare方法不需要判断返回值。
  // 为SQL语句绑定输入变量的地址,bindin方法不需要判断返回值。
  stmt.bindin(1,&iminid);
  stmt.bindin(2,&imaxid);
  // 为SQL语句绑定输出变量的地址,bindout方法不需要判断返回值。
  stmt.bindout(1,&stgirls.id);
  stmt.bindout(2, stgirls.name,30);
  stmt.bindout(3,&stgirls.weight);
  stmt.bindout(4, stgirls.btime,19);

  iminid=2;  // 指定待查询记录的最小id的值。
  imaxid=4;  // 指定待查询记录的最大id的值。

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
  if (stmt.execute() != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  // 本程序执行的是查询语句,执行stmt.execute()后,将会在数据库的缓冲区中产生一个结果集。
  while (1)
  {
    memset(&stgirls,0,sizeof(stgirls)); // 先把结构体变量初始化。

    // 从结果集中获取一条记录,一定要判断返回值,0-成功,1403-无记录,其它-失败。
    // 在实际开发中,除了0和1403,其它的情况极少出现。
    if (stmt.next() !=0) break;

    // 把获取到的记录的值打印出来。
    printf("id=%ld,name=%s,weight=%.02f,btime=%s\n",stgirls.id,stgirls.name,stgirls.weight,stgirls.btime);
  }

  // 请注意,stmt.m_cda.rpc变量非常重要,它保存了SQL被执行后影响的记录数。
  printf("本次查询了girls表%ld条记录。\n",stmt.m_cda.rpc);
}

运行效果

freecplus框架-Oracle数据库操作

5、查询超女表中的记录数

示例(counttable.cpp)

/*
 *  程序名:counttable.cpp,此程序演示freecplus框架操作Oracle数据库(查询表中的记录数)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  int icount=0;  // 用于存放查询结果的记录数。

  // 准备查询表的SQL语句,把查询条件直接写在SQL语句中,没有采用绑定输入变量的方法。
  stmt.prepare("select count(*) from girls where id>=2 and id<=4");
  // prepare方法不需要判断返回值。
  // 为SQL语句绑定输出变量的地址,bindout方法不需要判断返回值。
  stmt.bindout(1,&icount);

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
  if (stmt.execute() != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  // 本程序执行的是查询语句,执行stmt.execute()后,将会在数据库的缓冲区中产生一个结果集。
  // 但是,在本程序中,结果集永远只有一条记录,调用stmt.next()一次就行,不需要循环。
  stmt.next();

  printf("girls表中符合条件的记录数是%d。\n",icount);
}

运行效果

freecplus框架-Oracle数据库操作

7、删除超女表中的记录

示例(deletetable.cpp)

/*
 *  程序名:deletetable.cpp,此程序演示freecplus框架操作Oracle数据库(删除表中的记录)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  // 失败代码在stmt.m_cda.rc中,失败描述在stmt.m_cda.message中。
  // 如果不需要绑定输入和输出变量,用stmt.execute()方法直接执行SQL语句,不需要stmt.prepare()。
  if (stmt.execute("delete from girls where id>=2 and id<=4") != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  // 请注意,stmt.m_cda.rpc变量非常重要,它保存了SQL被执行后影响的记录数。
  printf("本次从girls表中删除了%ld条记录。\n",stmt.m_cda.rpc); 

  // 提交事务
  conn.commit();
}

运行效果

freecplus框架-Oracle数据库操作

8、执行PL/SQL过程

示例(execplsql.cpp)

/*
 *  程序名:execplsql.cpp,此程序演示freecplus框架操作Oracle数据库(执行PL/SQL过程)。
 *  作者:C语言技术网(www.freecplus.net) 日期:20190525
 *  说说我个人的看法,我从不在Oracle数据库中创建PL/SQL过程,也很少使用触发器,原因如下:
 *  1、在Oracle数据库中创建PL/SQL过程,程序的调试很麻烦;
 *  2、维护工作很麻烦,因为维护人员要花时间去了解数据库中的存储过程;
 *  3、采用freecplus框架操作Oracle已经是非常简单,没必要去折腾存储过程;
 *  4、PL/SQL过程可移植性不好,如果换成mysql或其它数据库,比较麻烦。
 *  还有,我在C/C++程序中很少用复杂的PL/SQL过程,因为复杂的PL/SQL调试麻烦。
*/
#include "_ooci.h"   // freecplus框架操作Oracle的头文件。

int main(int argc,char *argv[])
{
  connection conn; // 数据库连接类

  // 登录数据库,返回值:0-成功,其它-失败。
  // 失败代码在conn.m_cda.rc中,失败描述在conn.m_cda.message中。
  if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
  {
    printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
  }

  sqlstatement stmt(&conn); // 操作SQL语句的对象。

  int id=100;

  // 准备查询表的PL/SQL语句,先删除girls表中的全部记录,再插入一条记录。
  stmt.prepare("    BEGIN      delete from girls;      insert into girls(id,name,weight,btime)                 values(:1,‘超女过程‘,55.65,to_date(‘2018-01-02 13:00:55‘,‘yyyy-mm-dd hh24:mi:ss‘));    END;");
  // 注意,PL/SQL中的每条SQL需要用分号结束,END之后还有一个分号。
  // prepare方法不需要判断返回值。
  // 为PL/SQL语句绑定输入变量的地址,bindin方法不需要判断返回值。
  stmt.bindin(1,&id);

  // 执行SQL语句,一定要判断返回值,0-成功,其它-失败。
  if (stmt.execute() != 0)
  {
    printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
  }

  printf("exec PL/SQL ok.\n");

  // 提交事务。
  conn.commit();
}

运行效果

freecplus框架-Oracle数据库操作

9、CLOB和BLOB字段的操作

sqlstatement类还可以操作CLOB和BLOB字段,在实际开发中,这种需求不多,本文就不演示了,如果您在项目开发中有这方面的需求,可以参考demo程序,示例程序位于freecplus/db/oracle目录中,如下:

filetoclob.cpp:把文本文件存入数据表的CLOB字段。

clobtofile.cpp:把数据表CLOB字段中的内容导出到文本文件中。

filetoblob.cpp:把文本文件存入数据表的BLOB字段。

blobtofile.cpp:把数据表BLOB字段中的内容导出到文本文件中。

八、应用经验

freecplus框架的connection和sqlstatement类把OCI的强大功能充分的发挥了出来,且性能卓越。本文提供的示例程序看上去简单,实则很精妙,希望大家多多思考,慢慢体会。

为了让大家完全掌握connection和sqlstatement类的用法,我将录制freecplus框架的专题视频,请大家多关注C语言技术网(www.freecplus.net)发布的内容。

七、版权声明

C语言技术网原创文章,转载请说明文章的来源、作者和原文的链接。
来源:C语言技术网(www.freecplus.net)
作者:码农有道

如果这篇文章对您有帮助,请点赞支持,或在您的博客中转发我的文章,谢谢!!!
如果文章有错别字,或者内容有错误,或其他的建议和意见,请您留言指正,非常感谢!!!

freecplus框架-Oracle数据库操作

上一篇:freecplus框架-PostgreSQL数据库操作


下一篇:【学习总结】SQL的学习-2-sql操作