OTL：通用数据库连接模板

OTL介绍

OTL是一个纯C++开发的通用数据库连接模板，它支持时下流行的大多数数据库，例如：Oracle、Mysql、PostgreSql、Sybase、Sqllite、MS ACCESS、Firebird等。并且它有跨平台的特性，使用起来也非常简单，在Windows、Linux、MacOS上都可以使用。

OTL使用

下载地址：
http://otl.sourceforge.net/

OTL使用：
otl使用简单，只有一个头文件otlxxx.h，通常我们在使用的时候只需要在项目头文件中包含：#include <otlxxx.h>。

otl是根据宏定义来判断使用的是什么数据库驱动处理数据，例如我们需要连接的是postgepSql时，需要使用宏定义：
OTL_ODBC_POSTGRESQL或是OTL_ODBC（ODBC 为异构数据库访问提供统一接口）。

相关宏定义的列表在下面网页中可以查询到：
http://otl.sourceforge.net/otl3_compile.htm

--
- otl使用案例
--#include <otlv4.h>--定义一个连接数据库的连接实例，一个实例可以处理多个事务
otl_connect c; int main(){--初始化连接otl_connect::otl_initialize();try{--- 建立连接，str_login具体看需要连接的数据库是什么，例如postgrepsql，user/pass@dsn- 开启自动提交，在otl头文件中的otl_connect类中可以看到连接可以设置的功能--c.rlogon("str_login");c.auto_commit_on();-- 执行方式1，直接使用函数执行sql语句（通常用于DDL）otl_cursor::direct_exec(c, "str_sql");-- 执行方式2，使用流的方式（通常用于DML）otl_stream s; -- 使用open，或者是构造函数生成流，参考c++文件流s.open(bufsize, str_sql, c); -- bufsize表示缓存多少条数据后执行操作（类似缓冲区）s << idate -- 若为insert，插入数据s >> odate -- 若为select，读取数据}catch(otl_exception& e){--处理异常}-- 断开连接c.logoff();}

关于OTL封装中遇到的问题

封装OTL的思路

（1）建立多条与数据库的连接otl_connect ，并根据需要，将连接信息和连接的句柄封装到数据结构中（存放单条连接）；
（2）使用连接管理器管理封装好的连接；
（3）Sql操作通过流的方式来使用连接
（4）每次执行sql语句时，首先是从现有的连接中找，有，从现有连接中拿一条，替换流；没有即添加，如果添加连接数量超过最大值，等待已有连接运行结束。

使用封装遇到的问题(缓冲区问题)

问题场景
在插入数据时，一般会采用批量插入的方式，例如一次性插入5000条。
问题接口
sql的操作语句是使用连接中的流来执行，接口为：
otl_stream::open(bufsize/插入数量/, str_sql, connect)；
这是一个重载的函数，有很多种调用方式，具体可以参考otlvxx.h
问题原因
当流插入数据时，如果我们需要插入4000条，但是在插入1000时出现了异常，那么后面的3000条数据会因为抛出异常而被忽略，因此，需要在异常中处理，将后面的数据继续入库（或是遇到异常，即将后面数据重新插入）；
但是如果我们的数据不满足open时的bufsize，流是不会刷新（插入不会执行），只有等到该流被关闭时（析构）才会执行，而此时已经无法将析构中的异常抛出，导致出现异常后的数据无法入库。
解决方式
otl_stream::flush();

ODBC配置DSN

在otl的连接函数rlogon中需要填写连接参数字符串，使用odbc连接时该字符串的格式一般为（以linux下通过odbc连接PostgreSql数据库为例）：
user/passwd@dsn

除此之外，在服务器上配置odbc的sdn也是必须的。

例如，linux配置odbc连接postgresql数据库：
（1）在linux中下载，并安装unixODBC，安装完成后可以通过odbc_config --version查看odbc的版本，使用odbc_config --odbcini可以查看配置文件的路径；

（2）打开配置文件odbc.ini，填写数据源相关配置，例如：

[PGDB] #dsn名称
Description         = Test to Postgres
Driver              = PostgreSQL Unicode  #驱动名称
Trace               = Yes
TraceFile           = sql.log
Database            = xxx #数据库名称
Servername          = 127.0.0.1
UserName            = tttt  #用户名称
Port                = 5432
Protocol            = 6.4
ReadOnly            = No
RowVersioning       = No
ShowSystemTables    = No
ShowOidColumn       = No
FakeOidIndex        = No
MaxVarcharSize                  = 8096

（3）打开odbc驱动配置文件odbcinst.ini，填写驱动配置，例如：

[PostgreSQL Unicode ]#驱动名称
Description     = ODBC for PostgreSQL
Driver          = /usr/lib/psqlodbcw.so  #pg数据库驱动库文件
Setup           = /usr/lib/libodbcpsqlS.so
Driver64        = /usr/lib64/psqlodbcw.so
Setup64         = /usr/lib64/libodbcpsqlS.so
FileUsage       = 1
Threading   = 0

（4）配置完成后，可用isql -v xxx(库名)连接测试；
（5）使用otl连接测试。

注意：其他数据库，例如mysql，修改odbc配置即可