C++程序中使用OTL来操作Oracle数据库

如果经常使用C++连接数据库，你会发现OTL连接数据库确实挺方便的，你可以选择ODBC或者ADO等方式。但是，它所有的代码都放在一个头文件otlv4.h中，我们在写程序的时候直接将头文件包含进来，就可以调用其中的类中的函数进行数据库的连接，增删改查等操作。最近一直在使用Oracle数据库，这次就使用OTL连接Oracle数据库，Oracle数据库提供一个调用的接口（OCI），是Oracle公司开发的一个应用程序开发工具，是一个通过访问Oracle数据库的服务器，控制各类sql语句的执行，进而创建应用程序接口（API），OTL就是通过OCI对Oracle数据库进行操作。

OTL 是 Oracle, Odbc and DB2-CLI Template Library 的缩写，是一个C++编译中操控关系数据库的模板库，它目前几乎支持所有的当前各种主流数据库，例如Oracle, MS SQL Server, Sybase, Informix, MySQL, DB2, Interbase / Firebird, PostgreSQL, SQLite, SAP/DB, TimesTen, MS ACCESS等等。OTL中直接操作Oracle主要是通过Oracle提供的OCI接口进行，进行操作DB2数据库则是通过CLI接口来进行，至于MS的数据库和其它一些数据库，则OTL只提供了ODBC来操作的方式。当然Oracle和DB2也可以由OTL间接使用ODBC的方式来进行操纵。

在Windows和Unix 平台下，OTL目前支持的数据库版本主要有：Oracle 7 (直接使用 OCI7), Oracle 8 (直接使用 OCI8), Oracle 8i (直接使用OCI8i), Oracle 9i (直接使用OCI9i), Oracle 10g (直接使用OCI10g), DB2 (直接使用DB2 CLI), ODBC 3.x ,ODBC 2.5。OTL最新版本为4.0，参见http://otl.sourceforge.net/，下载地址http://otl.sourceforge.net/otlv4_h.zip。

【注意】在里面有一个auto_commit_on函数是来设置auto_commit标志的，当auto_commit=1是设置每一个执行的SQL语句都会自动提交，就是做一步就有一步的改变，如果是等于0，那么就是要整个sql语句成功才算成功

OTL很好用，结合官方提供的一些例子，多多尝试才能领悟。其中有些地方，比如对网络异常的处理，可是费了我两天的时间才解决的。废话少说，开始正题：

一、开始前的准备工作
在使用OTL进行编程之前，要首先确定使用的Oralce版本以及所选用的字符集。OTL支持目前几乎所有的主流数据库，可以通过宏启用otlv4.h中对应的数据库操作接口。
如：使用Oracle 11g R2、字符集选择UTF8，则可在包含otlv4.h之前声明以下两个宏：
 #define OTL_ORA11G_R2
#define OTL_ORA_UTF8
#include "otlv4.h"
....
二、常用类及其常用成员
1. otl_connect类
static int otl_initialize(const int threaded_mode=0):
用于初始化OTL环境的静态函数，参数指定是用于多线程还是单线程。它不保证线程安全，也就是说，如果多个线程共享使用一个otl_connect对象，需要加锁进行控制。有个同事因为在多线程环境下使用了默认的参数0，就导致了程序异常。但是单线程环境下，参数设1是没有问题的。所以，可以考虑将此参数直接设为1。
void rlogon(...)：
这个函数有多个版本，请注意参考官方文档中与相应数据库版本对应的函数声明。11g中用到的参数说明如下：
const char *connect_str:连接字符串，格式为："用户名/密码@数据库服务名"
const int aauto_commit:自动提交模式。若此参数设为0（默认），则通过此连接对象执行的事务不会自动提交。如使用direct_exec执行删除记录的操作时，需要手动调用commit()成员函数提交事务；若设为1则通过此otl_connect对象开启的事务会自动提交。
long direct_exec(...)：
const char *sqlstm: 指定所要执行的“静态SQL语句”，即不产生输入或输出的SQL语句。如delete from book where name='c++‘ 。但是不能执行如select sysdate from dual或select * from book亦或delete from book where name=:f1之类的语句，因为它们会带有输入或输出，此类SQL语句可以通过otl_stream实现，下面会有介绍。
int ignore_error:是否忽略异常。可以指定otl_exception::disable禁用异常，否则程序需要使用try...catch(otl_exception &e)...捕获并处理异常。
int connected:
此成员变量标识了连接对象是否连接成功，一旦连接成功其值即为1。即便后来网络断掉了，此值仍旧保持不变，logoff()后此值变为0。所以此变量只能用于检查rlogon是否连接成功，而不能判断当前与数据库的连接是否正常。
 
2. otl_stream类
void open(...):
为流对象关联一个SQL语句，可以是带输入或输出的SQL语句或PL/SQL块。
const int arr_size:指定流缓冲区的大小。作为输出流使用时，若输出缓冲区中的记录数达到此值即缓冲区满时，会自动刷新缓冲区，若已设设置了自动提交则一并提交数据（默认）;
const char *sqlstm:SQL语句，可以指定绑定变量，如：delete from book where id = :f1 and price = :f2；
otl_connect &db:流所使用的数据库连接对象。
void set_commit(int auto_commit=0):
设置流被刷新时否自动提交事务。两种条件下流会被刷新：a.缓冲区满  b.手动调用flush成员函数
void flush(...):
执行和流关联的SQL语句。如执行：
otl_stream delStream;
delStream.open(100, delete from book where id = :f1 and price = :f2, dbConnect);  //正常情况下向流中加入100条记录时才执行删除
delStream << 1;
delSteam << 'C++';
delStream.flush();        //立即执行删除操作，尽管当前流中只有一条记录
long get_rpc():
获取流中SQL语句执行后所影响到的记录数，如插入100条记录，则调用此函数返回的即为100
int good():
判断流对象是否已正常打开，已打开返回1。注意：若复用一个流对象时，必须先调用close函数将其关闭，然后再调用open重新打开。
int get_dirty_buf_len():
获取当前流对象缓冲区中的记录数，其最大值为缓冲区size-1。每当缓冲区满时会自动刷新，刷新后再调用此函数时返回0
 
3.otl_exception类
该类的几个成员用于表示异常的信息，如：
char stm_text[2048]:出错的SQL语句；
char var_info[256]:若在流中使用了与实际类型不符的绑定变量，此数组的值为绑定变量的信息；
unsigned char msg[1000]:这个我比较喜欢用，此数组显示出具体的异常信息（包括oracle返回的错误码），如连接超时等等。

三、对于网络异常的处理
现在项目对于程序的异常处理能力要求越来越高，比如网络中断或数据库出现异常等，要求在故障恢复后，程序能正常与数据库保持连接，使业务尽可能的少受影响。可以通过以下方法解决此种情况。这也是折磨了我两天的一个问题：(
首先，程序要在提交数据的地方使用try...catch捕获otl_exception异常，当提交失败时，otl会抛出此异常并携带异常信息；
其次，要在捕获到异常之后，关闭之前的连接对象（如果有流使用此连接对象，则一定要先关闭流对象，然后再断开otl_connect对象）；
最后，重新连接数据库并再次初始化流对象。
如：

void ReConnect(otl_connect &otlConnect, const char *pConnStr, int iAutoCommit);
....


//声明otl对象并初始化对象
otl_connect dbConn;
otl_stream outStream;
 
void Init(void)
{
 try
 {
  otl_connect::otl_initialize(1);
  dbConn.rlogon("test1/password@testdb");
  outStream.open(100, "insert into book values(:f1, :f2, :f3, :f4)", dbConn);
  outStream.set_commit(1);
 }
 catch (otl_exception &e)
 {
  //处理异常
 }
}
 
//提交数据的函数
void Submit(void)
{
 try
 {
  for (int i = 0; i < 5000; i++)
  {
   outStream << i;
   outStream << "abc";
   outStream << i;
   outStream << "null";
  }
 }
 catch(otl_exception &e)
 {
  //提交数据异常，重新连接数据库并重新初始化流对象
  outStream.close();      //必须先关闭流对象。若先断开连接会出现关闭流对象时报OCIHandleFree异常导致流对象无法正常关闭引起内存泄漏
  ReConnect（dbConn, "test1/password@testdb", 0);
  outStream.open(100, "insert into book values(:f1, :f2, :f3, :f4)", dbConn);
  outStream.set_commit(1);
 }
}
 
//重新连接连接数据库函数
void ReConnect(otl_connect &otlConnect, const char *pConnStr, int iAutoCommit)
{
 if (1 == otlConnect.connected)
 {
  otlConnect.logoff();
 }
Retry:
 try
 {
  otlConnect.rlogon(pConnStr, iAutoCommit);
 }
 catch (otl_exception &e)
 {
  Sleep(1000);
  goto Retry;
 }
}

这样，调用Submit函数提交数据时，就有了网络异常处理功能，若提交失败则会一直尝试重新连接，直到连接成功为止。