OTL编程指南.doc

OTL 编程简介 功能 OTL是Oracle 和 ODBC 的模板库，它屏蔽数据库操作的底层，提供数据库连接功能，以标准 C++ 流的方式完成嵌入式 SQL 语句、存储过程的执行和光标操作。 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的方式来进行操纵。在MS Windows and 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，参见/，下载地址/otlv4_h.zip。优点：a. 跨平台b. 运行效率高，与C语言直接调用API相当c. 开发效率高，起码比ADO.net使用起来更简单，更简洁d. 部署容易，不需要ADO组件，不需要.net framework 等CDBConnGuard 类屏蔽之并进行连接等管理。） 主要成员函数： int connected; // 是否已经连接到数据库 static int otl_initialize(const int threaded_mode=0); // 初始化 OTL 环境，必须在调用 OTL API 之前被调用；threaded_mode=1表示运行在多线程环境 void set_max_long_size(const int amax_size); // 设置缓冲区大小（仅对大数据字段适用） otl_connect(const char* connect_str,const int auto_commit=0); // connect_str的格式：USER/PASSWORD@TNS_ALIAS，如果是本地连接则不需要TNS_ALIAS void rlogon(const char* connect_str,const int auto_commit=0); void logoff(); void server_attach(const char* tnsname=0); // OTL/OCI8 only void server_detach();// OTL/OCI8 only session_begin(const char* username, const char* password, const int auto_commit=0);// OTL/OCI8 only void session_end();// OTL/OCI8 only void session_reopen(const int auto_commit=0)// OTL/OCI8 only，打开用 session_end 关闭的会话 void commit(); void rollback(); 注释：使用 server、session来登录比用 rlogon 效率更高 建议使用显式的 commit 和 rollback，不使用 autocommit otl_stream 类 概述 以宿主调用和流的方式完成 SQL 语句的执行。 工作原理：先分析程序员指定的 SQL 语句，之后以流的方式把数据和 otl_stream 内部的缓冲区作交换，通过 flush() 将数据刷新到数据库中。 otl_nocommit_stream 主要成员函数 otl_stream( const short arr_size, const char* sqlstm, otl_connect db, const char* ref_cur_placeholder=0) ) 构造函数 arr_size表示缓冲记录的条数 sqlstm 表示要执行的 SQL 语句 db 表示使用的数据库连接 ref_cur_placeholder 表示返回的光标（如果有的话）的