开发者社区> nothingfinal> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

OTL技术应用

简介:
+关注继续查看
  • 什么是OTL:OTL 是 Oracle, Odbc and DB2-CLI TemplateLibrary 的缩写,是一个操控关系数据库的C++模板库,它目前几乎支持所有的当前各种主流数据库,如下表所示:
 

数据库

访问接口

支持版本

Oracle

OCI

OCI7、OCI8、OCI8i、OCI9i、OCI10g

DB2

CLI

DB2 CLI

MS SQL Server

、Sybase、Informix

、MySQL、 Interbase/Firebird、PostgreSQL、SQLite、SAP/DB、TimesTen、MS ACCESS

ODBC

ODBC2.5、ODBC3.x

 

Oracle和DB2也可以由OTL间接使用ODBC的方式来进行操纵。

OTL中直接操作Oracle主要是通过Oracle提供的OCI接口进行,依赖于Oracle客户端。 

OTL使用简单, 只要头文件中包含有: #include “otlv4.h” 就可,实际上整个OTL就一个“.H”的文件,使用起来极为的方便。

 

优点

(1).跨平台

(2).运行效率高,与C语言直接调用数据库API相当

(3).开发效率高,使用方便,繁在其内,简在其外,比

    ADO.net使用起来更简单,更简洁

(4).部署容易,不需要ADO组件,不需要.net

    framework 等

缺点

(1).只能在C++中使用

 

  • OTL的主要类

主要类包括:otl_stream、otl_connect、otl_exception

•otl_stream类

    otl_stream类是OTL“流”的概念的具体表现形式,任何通过输入/输出参数使用SQL语句、PL/SQL 块或者是存储过程调用,在C++的编程中都能通过otl_stream类来实现。

        其构造函数为:

   (1)for Oracle 7/8/9/10:

   otl_stream(const int arr_size, // 流的缓存大小

                      const char* sqlstm, // SQL语句或PL/SQL块或存储过程                     

                      otl_connect& db, // OTL数据库连接对象

                       const char* ref_cur_placeholder=0, // 游标引用占位符名称   

                       const char* sqlstm_label=0 // SQL 语句标签);

 

(2)forODBC/DB2-CLI:

  otl_stream(const int arr_size,// 流的缓存大小

           constchar* sqlstm,// SQL语句或PL/SQL块或存储过程                    

           otl_connect& db,// OTL数据库连接对象

            const int implicit_select=otl_explicit_select ,

            const char* sqlstm_label=0//SQL 语句标签);

  OTL流构造函数,负责创建otl_stream对象并调用open()(解析sql语句)方法。

  otl_stream的性能主要被缓冲区大小arr_size一个参数控制。缓冲区大小定义了插入表的逻辑行以及与数据库一次往反交互(one round-trip to the database)过程中从表或视图中查询的逻辑行。

(3)void set_commit(int auto_commit=0);

  设置流的auto_commit标志。默认情况下,该标志被置1,即当输出缓冲区刷新时,当前的事务被自动提交。

  注意流的auto_commit标志和数据库的自动提交模型没有任何关系。

(4)void set_flush(const bool auto_flush=true);

  设置auto_flush标志。默认情况下auto_flush的值为true, 即如果缓冲区出现脏数据则在流的析构函数中刷新缓冲区。如果自动刷新标志被关闭,则需要使用close()方法或者flush()方法对流进行刷新。

  注意该函数仅仅能够设置流的析构函数中是否自动刷新,并不是通常意义上的缓冲区刷新。

(5)voidflush(void);

  刷新流的输出缓冲区。当输出缓冲区被填满时,缓冲区将被自动刷新。如果流的auto_commit标志被置上,则在刷新完毕后当前事务被提交。

•otl_connect类

otl_connect类封装了一系列有关数据库连接的功能:建立连接、断开连接、事务提交、事务回滚等等。换言之,otl_connect是在C++编程中创建和使用数据库连接以及进行数据库事务管理的类,主要方法有:

(1)static int otl_initialize(const int threaded_mode=0);

该静态方法的主要功能是初始化OTL数据库环境,程序中第一次建立与数据库的连接之前,必须调用该方法一次,其后再建立与数据库的连接,就不需要调用该方法了。如果程序是在多线程环境下访问数据库,参数threaded_mode需置为1。另外在多线程环境下访问数据库,不要多个线程操作同一个otl_connect对象,除非该ot_connect对象有互斥锁机制。

 

 (2) otl_connect(const char* connect_str,const int auto_commit=0);

  连接数据库。参数同rlogon(),见(3)rlogon()

(3) void rlogon(const char* connect_str,const int auto_commit=0);

     该方法的主要功能是建立与数据库的连接。

     参数connect_str是数据库连接配置字符串,有两种表达形式

     o OTL4.0/OCIx

       ■”USER/PASSWORD”(本地数据库)

       ■”USER/PASSWORD@TNS_ALIAS”(远程数据库)

     o OTL4.0/ODBC和OTL4.0/DB2_CLI

       ■”USER/PASSWORD@DSN”

       ■”DSN=value;UID=value;PWD=value”

     参数auto_commit设置数据库事务的提交模式,auto_commit设置为1,表示数

 据库事务自动提交;auto_commit设置为0,表示数据库事务非自动提交,auto_commit

 缺省为0。

(4) void logoff(void);

  该方法的主要功能是断开与数据库的连接。

(5) void commit(void);

  该方法的主要功能是提交数据库事务。

(6) void rollback(void);

  该方法的主要功能是回滚数据库事务。

(7) void auto_commit_off(void); void auto_commit_on(void);

  设置otl_connect对象的auto_commit标志  

(8) long direct_exec(constchar *sqlstm,

  int ignore_error = otl_exception::enabled );

  直接执行静态(无绑定变量)的SQL语句 ,该函数返回处理的行数。-1:处理异常;>=0:在执行INSERT、DELETE或UPDATE语句时,实际返回的是已处理行数

•otl_exception类

       otl_exception类用于描述OTL操作数据时抛出的异常,有3个主要的成员变量:

       (1)unsignedchar msg[1000];

       该成员变量用于保存存异常的具体错误信息。

       (2)char stm_text[2048];

       该成员变量用于保存导致发生异常错误的SQL语句。

       (3)char var_info[256];

       该成员变量用于保存导致发生异常错误的输入/输出变量。

OTL使用起来也很简单,使用不同的数据库连接,主要是根据需要在程

序开始的宏定义来指定的。OTL是首先根据这个宏定义来初始化数据库

连接环境。OTL中用来区分连接方式的宏定义主要有下面这些:

OTL_ORA7,OTL_ORA8, OTL_ODBC, OTL_DB2_CLI, OTL_ODBC_MYSQL...

   不同的宏对应的数据库API,具体说明如下:

宏定义名

说明

OTL_ORA7

for OCI7

OTL_ORA8

for OCI8

OTL_ORA8I

for OCI8i

OTL_ORA9I

for OCI9i. All code that compiles and works under #define OTL_ORA7, OTL_ORA8, and OTL_ORA8I, should work when OTL_ORA9I is used

OTL_ORA10G

for OCI10g. All code that compiles and works  under #define OTL_ORA7, OTL_ORA8, OTL_ORA8I, OTL_ORA9I, should work with OTL_ORA10G.

OTL_ORA10G_R2

for OCI10g, Release 2 (Oracle 10.2). All code that compiles and works  under #define OTL_ORA7, OTL_ORA8, OTL_ORA8I, OTL_ORA9I, and OTL_ORA10G should work with OTL_ORA10G_R2

OTL_DB2_CLI

for DB2 Call Level Interface (CLI)

OTL_INFORMIX_CLI

for Informix Call Level Interface for Unix (when  OTL_ODBC_UNIX is enabled).

OTL_IODBC_BSD

for ODBC on BSD Unix, when iODBC package is used

OTL_ODBC

for ODBC

OTL_ODBC_MYSQL

for MyODBC/MySQL. The difference between OTL_ODBC_MYSQL and OTL_ODBC is that transactional ODBC function calls are turned off for OTL_ODBC_MYSQL, since MySQL does not have transactions

OTL_ODBC_

POSTGRESQL

for the PostgreSQL ODBC driver 3.5 (and higher) that are connected to PostgerSQL 7.4 / 8.0  (and higher)  servers.

OTL_ODBC_UNIX

for ODBC bridges in Unix

OTL_ODBC_zOS

for ODBC on IBM zOS.

OTL_ODBC_XTG_IBASE6

for Interbase 6.x via XTG Systems'  ODBC driver. The reason for introducing this #define is that the ODBC driver is the only Open Source ODBC driver for Interbase. Other drivers, like Easysoft's ODBC for Interbase, are commercial products, and it beats the purpose of using Interbase, as an Open Source.database server.

 

 

绑定变量

•示例:

  INSERT INTO my_table (employee_id, supervisor_name)VALUES(

  :employee_id<int>,

  :supervisor_name<char[33]>)

•placeholder(比如employee_id)可以用没有意义的f1代替,但是在一个SQL语句中不能使用相同名字的placeholder
•在执行INSERT语句的时候,如果数据库中char字段的大小是n,则这个INSERT语句的绑定变量的大小要为n+1;否则当邦定变量的大小为n时,执行INSERT会出错。
•对数据库中定义的数字字段,可以根据字段的大小使用16位、32 位的整数和double类型;当然,如果对所有OCI的数字字段使用double,也不会出错。
 
•OTL的一般使用步骤包括:

(1)  使用宏指明底层数据库API类型和控制编译器对OTL的编译。例如:#define OTL_ORA9I      // Compile OTL 4.0/OCI9i

(2)  创建otl_connect对象,该对象一般为全局共享的。

(3)  调用otl_connect的静态方法otl_initialize()初始化OTL环境。

(4)  调用otl_connect的rlogon()方法连接数据库。

(5)  创建otl_stream()对象,该对象一般为局部的。

(6)  使用otl_stream的<<操作符绑定SQL中的变量。

(7)  使用otl_stream的>>操作符读取返回结果。

(8)  调用otl_connect的logoff()方法从数据库断开。

 

 

代码

 

•SQL使用举例(常量SQL使用):

   常量SQL就是不带任何绑定变量的SQL,OTL通过一个静态方法来操作:

   long otl_cursor::direct_exec(otl_connect&db,//OTL数据库对象

                                const char* sqltm,//SQL语句

                            otl_exception_disable=0,//OTL异常忽略标志

                           );

   返回值:

   ●-1,如果otl_exception_disable被设置成1,并且OTL的底层API发生错误

   ●>=0,SQL执行成功,返回实际处理成功的记录数.

   o Examples(Oracle)

 

代码

 

 

输出:

A=2,B=Test Stri ng1

A=3,B=Test String2

A=4,B=Test String3 

 

常量PL/SQL块的使用与常量SQL的使用类似,在此不再赘述。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Python编程:使用数据库sqlite3
Python编程:使用数据库sqlite3
0 0
13-TDengine使用JDBC-JNI连接报错:JNI connection is NULL
13-TDengine使用JDBC-JNI连接报错:JNI connection is NULL
0 0
OTL实战小结
前言: 以下内容是项目中使用OTL的部分小结,适合OTL初学者。大牛请绕行。
0 0
OTL技术应用
什么是OTL:OTL 是 Oracle, Odbc and DB2-CLI TemplateLibrary 的缩写,是一个操控关系数据库的C++模板库,它目前几乎支持所有的当前各种主流数据库,如下表所示:   数据库 访问接口 支持版本 Oracle OCI...
733 0
OTL调用Oracle存储过程
OTL很早前用过,今天写东西要调存储过程,程序写完了,调试死活通不过,折腾了一早晨。 最后才发现错误,这里总结一下: 1、代码写的不规范。 有个参数后边少写了个“,”以至于总是抱错。而单独写的测试例子就没问题,后来一步一步跟踪了后才发现。
687 0
在MFC中使用OTL库连接数据库
 http://hyhvi.iteye.com/blog/1549639 在Win32控制台程序下,要使用OTL库,只需在程序加入OTL头文件,并写上以下两句代码即可(ODBC方式):     #define OTL_ODBC      #include "otlv4.
754 0
数据库操作:MYSQL与MFC连接(二)
继上一片博客,这篇介绍数据库与MFC的连接,上篇是介绍用控制台连接MYSQL,其实MFC为代码增加一个界面,和一些消息相应(个人认为) 首先建一个MFC的工程,我这边建了一个Dlg 建好后看一下选项-> 目录->包含目录和库目录中是否包含了MYSQL的路径 再在Dlg.cpp中添加: #include”winsock.h” #include“mys
2319 0
OTL使用总结
在VC中访问Oracle,可以使用ADO或ODBC,如果你比较强大,也可以直接使用OCI API,但我个人认为OTL是最佳选择,它是一套数据库访问C++模板库,全部代码都在otlv4.h头文件中,通过OTL不但可以访问Oracle数据库(使用OCI  API),还可以访问DB2,或者使用ODBC连接字符串访问其他数据库。
909 0
+关注
nothingfinal
软件开发,安全加密
文章
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载