ProCC+++编程.docx

1、ProCC+编程Pro*C/C+ 编程Pro*C/C+ 编程 1一、Pro*C/C+ 简介 11.1、Pro*C/C+ 是什么 11.2、Pro*C/C+ 处理流程 2二、Pro*C/C+ GCC 环境配置 32.1、Pro*C/C+ 预编译环境 32.2、GCC 编译器 5三、开始编写第一个Pro*C+代码 53.1、第一个Pro*C+代码 53.2、Pro*C+代码预编译 63.3、GCC 编译 73.4、最后测试 8四、复杂一些的Pro*C/C+代码 84.1、代码部分 84.2、代码编译 124.3、代码测试 14一、Pro*C/C+ 简介1.1、Pro*C/C+ 是什么为了用户开发O

2、racle应用程序, Oracle提供了一套Oracle调用规范, 即Oracle Call Interface (OCI),但是比较难以掌握使用, 对于熟悉 C/C+ 的用户要编写Oracle应用程序, 还需要花很多时间去研究 OCI, 因此 Oracle 推出了一个在 C/C+ 代码中直接嵌入 SQL 的方法, 然后通过 Oracle 提供的预编译程序, 编译成SQLLIB的调用, 这就是 Pro*C/C+。注意, SQLLIB 与 OCI 是不同的, SQLLIB 主要是保含一系列函数的Oracle 应用程序运行库，用于应用程序执行或预编译时调用，其本身并不是Oracle 标准接口API

3、，随着Oracle 版本的变化SQLLIB 的函数调用格式、用法、参数等也有可能变化。如果一个项目中需要一个比较通用的、平台一致性好的、不随数据库版本变化而变化的一系列封装函数，最好的建议是使用Oracle Call Interface (OCI) 进行标准C 语言的编程处理。 1.2、Pro*C/C+ 处理流程C/C+ 源代码 = 源代码中嵌入SQL = 通过 Pro*C 预编译命令产生新的源代码 = 通过正常的C/C+编译器编译连接应用程序 = 运行应用程序 二、Pro*C/C+ GCC 环境配置2.1、Pro*C/C+ 预编译环境当您安装 Oracle 数据库产品的时候,Pro*C/C+

4、的预编译环境缺省就为我们安装好了,我们这里以安装 Oracle 10G 版本为例. 在 Oracle_Home的 Bin 目录下, 您可以找到预编译程序 proc.exe, 这个就是用来预编译您有在C/C+代码中嵌入SQL的文件的. 该编译程序用到了 Oracle_Home下的precomppublic 目录中的 .h 头文件, 在正真编译生成可执行文件时又会用到 precomplib 的一个 .lib 库文件. 我们进入 command 窗口,看看 proc 编译命名的参数: Pro*C/C+编译命令参数(10G)C:oracleproduct10.2.0db_2BINprocPro*C/C

5、+: Release 10.2.0.1.0 - Production on Mon Feb 23 16:22:29 2009Copyright (c) 1982, 2005, Oracle. All rights reserved.System default option values taken from: C:oracleproduct10.2.0db_2precompadminpcscfg.cfgOption Name Current Value Description-auto_connect no Allow automatic connection to ops$ account

6、char_map charz Mapping of character arrays and stringsclose_on_commit no Close all cursors on COMMITcmax 100 CMAX Value for connection poolcmin 2 CMIN Value for connection poolcincr 1 CINCR Value for connection poolctimeout 0 CTIMEOUT Value for connection poolcnowait 0 CNOWAIT Value for connection p

7、oolcode cpp The type of code to be generatedcomp_charset multi_byte The character set type the C compiler supportsconfig default Override system configuration file with anothercpool no Support connection poolingcpp_suffix cc Override the default C+ filename suffixdbms native v6/v7/v8 compatibility m

8、odedef_sqlcode no Generate #define SQLCODE sqlca.sqlcode macrodefine *none* Define a preprocessor symbolduration transaction Set pin duration for objects in the cachedynamic oracle Specify Oracle or ANSI Dynamic SQL Semanticserrors yes Whether error messages are sent to the terminalerrtype *none* Na

9、me of the list file for intype file errorsevents no Support publish-subscribe event notificationsfips none FIPS flagging of ANSI noncompliant usageheader *none* Specify file extension for Precompiled Headershold_cursor no Control holding of cursors in the cursor cacheiname *none* The name of the inp

10、ut fileinclude *none* Directory paths for included filesintype *none* The name of the input file for type informationlines no Add #line directives to the generated codelname *none* Override default list file nameltype short The amount of data generated in the list filemaxliteral 1024 Maximum length

11、of a generated string literalmaxopencursors 10 Maximum number of cached open cursorsmode oracle Code conformance to Oracle or ANSI rulesnative_types no Support for native float/doublenls_char *none* Specify National Language character variablesnls_local no Control how NLS character semantics are don

12、eobjects yes Support object typesoname *none* The name of the output fileoraca no Control the use of the ORACApagelen 80 The page length of the list fileparse none Control which non-SQL code is parsedprefetch 1 Number of rows pre-fetched at cursor OPEN timerelease_cursor no Control release of cursor

13、s from cursor cacheselect_error yes Control flagging of select errorssqlcheck SEMANTICS Amount of compile-time SQL checkingsys_include *none* Directory where system header files are foundthreads no Indicates a multi-threaded applicationtype_code oracle Use Oracle or ANSI type codes for Dynamic SQLun

14、safe_null no Allow a NULL fetch without indicator variableuserid *none* A username/password dbname connect stringutf16_charset nchar_charset The character set form used by UTF16 variablesvarchar no Allow the use of implicit varchar structuresversion recent Which version of an object is to be returne

15、dwin32_threads no Support windows default local threadingPCC-F-02135, CMD-LINE: User asked for help这些命令参数选项,除了直接在命令行参数中指定外,您也可以通过 precompadminpsccfg.cfg 文件中进行指定, 下面是一个样例: ltype=shortcode=cppcpp_suffix=ccparse=noneSQLCHECK=SEMANTICS这里我们介绍其中的三个参数: code=cpp 这个参数表明我们通过 proc 预编译命令产生的代码文件是符合 C+ 规范的,如果您是在标

16、准C环境中使用, 那么您可以指定 code=ansi_c cpp_suffix=cc 这个参数让 proc 命令产生的文件以 .cc 作为文件扩展名 SQLCHECK=SEMANTICS 这个参数用于指示在预编译的时候是否要检查嵌入的SQL的语法,您可以设置 NONE 表示不检查(10G中中已经不再支持这个值了,至少设置为 SYNTAX), SEMANTICS 表示检查语义(也就是检查数据库表名,列名是否存在等)2.2、GCC 编译器在 Windows 环境中, 您可以选择使用微软的 VC 编译器, 或者 Bland公司的 BC 编译器. 我们这里使用 GCC 1) 编译器, GCC 编译器的

17、安装可以直接从 http:/gcc.gnu.org 这里下载, 最新提供一个在Windows下快速安装的工具程序.这里我们采用了 Dev-CPP 的开发环境, 这个开发环境中包含了 GCC, 下载地址见 三、开始编写第一个Pro*C+代码3.1、第一个Pro*C+代码本文中涉及到的 C+ 知识不做过多介绍,已经超出了本文范围. 编写一个 Oracle 登陆程序(我们这里使用 C+ 代码, 当然您也可以使用 标准C 代码): 1: using namespace std; 2: #include 3: #include sqlca.h / SQL Comunication Area 4: 5:

18、EXEC SQL BEGIN DECLARE SECTION; 6: char *uid = scott/tigerorcl10g; 7: EXEC SQL END DECLARE SECTION; 8: 9: int main()10: 11: EXEC SQL CONNECT :uid;12: if (sqlca.sqlcode != 0)13: coutsqlca.sqlerrm.sqlerrmcendl;14: else15: coutSuccess.set ORACLE_HOME=C:oracleproduct10.2.0db_2C:set path=%ORACLE_HOME%bin

19、C:cd procC:procdir /bmyfirst.pcC:procproc myfirst.pcPro*C/C+: Release 10.2.0.1.0 - Production on Wed Feb 25 13:58:52 2009Copyright (c) 1982, 2005, Oracle. All rights reserved.System default option values taken from: C:oracleproduct10.2.0db_2precompadminpcscfg.cfgC:procdir /bmyfirst.ccmyfirst.lismyfi

20、rst.pcC:proc以上已经与编译成功,我们可以看到新产生了 myfirst.cc 文件, 这个文件就是将嵌入的SQL指令预编译成为标准的ORACLE库函数调用后的文件.您可以查看该文件内容. 3.3、GCC 编译在进行预编译产生正常的C+代码文件后, 接下来, 我们只需要用 C+ 编译器编译这个 .cc 文件即可得到我们的可执行文件. 我们首先需要设置一下 Path, 以便找到我们的编译器, 我的 gcc 编译器在 c:Dev-Cppbin 目录下, 由于这里使用的是 C+ 的编程, 所以我使用 g+ 编译命令 C:procset path=C:Dev-Cppbin;%path%C:pr

21、ocg+ myfirst.ccmyfirst.cc:145:19: sqlca.h: No such file or directorymyfirst.cc: In function int main():myfirst.cc:167: error: sqlca undeclared (first use this function)myfirst.cc:167: error: (Each undeclared identifier is reported only once for each function it appears in.)这里出错了,因为 sqlca 这个结构变量没有找到,

22、 实际上是没有找到 sqlca.h 这个头文件, 这个头文件在 %ORACLE_HOME%precomppublic 目录下, 因此我们通过命令行指定这个位置: C:procg+ myfirst.cc -I %ORACLE_HOME%precomppublicC:DOCUME1nyforLOCALS1Temp/ccgLbaaa.o(.text+0x2b9):myfirst.cc: undefined reference to sqlcxtcollect2: ld returned 1 exit statusC:proc依然有错误,提示找不到 sqlcxt 的引用, 这个是在链接的时候发生的错误

23、, 链接时需要一个Oracle库文件, 这个库文件位置在 %ORACLE_HOME%precomplib目录中,文件名为: orasql10.lib, Oracle 9i 的文件名为 orasql9.lib 我们指定库文件路径及库文件后重新编译: C:procg+ myfirst.cc -I %ORACLE_HOME%precomppublic -L %ORACLE_HOME%precompLIB -l orasql10C:procdir /ba.exemyfirst.ccmyfirst.lismyfirst.pcC:proc至此, 我们成功生成了一个可执行文件 a.exe , 这个文件可以用

24、来测试登陆. 3.4、最后测试当我们生成好了可执行文件后, 我们开始测试, C:procaSuccess.当我们把 Oracle Listener 停掉后再行测试 C:procaORA-12170: TNS:Connect timeout occurred四、复杂一些的Pro*C/C+代码4.1、代码部分这里我们直接在代码中编写注释, 以阐释Pro*C/C+中的一些基本指令的用法 using namespace std;#include #include sqlca.h /引入 SQL 通讯区/以下申明一个宿主变量,这是一个全局的变量,这个变量在C代码中和正常的变量一样使用,/在嵌入SQL语句

25、中,在变量名前追加冒号:来引用该变量.EXEC SQL BEGIN DECLARE SECTION; /只有包含在这之间申明的变量才能用于嵌入SQL代码中 char *uid = scott/tiger/192.168.8.35:1522/orcl10;EXEC SQL END DECLARE SECTION;/这里申明了一个函数,后面会做说明,代码实现在最后void sql_error();int main()/*这条指令指示嵌入SQL执行发生错误的时候(不包含NO_DATA_FOUND例外)转向执行的C函数 这个指令还有其它一些语法: EXEC SQL WHENEVER SQLERROR

26、CONTINUE; 继续执行下一条语句 EXEC SQL WHENEVER SQLERROR STOP; 停止应用程序的执行 EXEC SQL WHENEVER SQLERROR GOTO label; 跳转到指定的标号处运行 初始状态为 CONTINUE */ EXEC SQL WHENEVER SQLERROR DO sql_error();/*这条指令连接数据库, 常用的连接方法有两种: 一是将用户名和密码存放在两个宿主变量中， 采用 IDENTIFIED BY 子句： EXEC SQL CONNECT :username IDENTIFIED BY :password ; 一是将用户名

27、和密码按照“username/password”方式（在用户名和密码中用反斜线做分隔的字符串）存放在一个宿主变量中： EXEC SQL CONNECT :usernameandpwd;*/ EXEC SQL CONNECT :uid; coutDatabase Connected.endl; EXEC SQL WHENEVER SQLERROR CONTINUE; /下面这条指令是执行一条本机动态SQL语句,语法和PL/SQL中类似 EXEC SQL EXECUTE IMMEDIATE drop table t_emp; /前面代码当SQL执行发生错误时设置的CONTINUE,我们在下一条语句

28、检查执行结果 if (sqlca.sqlcode = 0) / sqlcode 为 0 表示执行成功. coutTable T_EMP droped.endl; EXEC SQL WHENEVER SQLERROR DO sql_error(); /以下是嵌入的普通的DDL语句,执行完后我们没有检测 sqlca.sqlcode , /是因为前面我们设置了出错时进行捕获并执行 sql_error() 函数 /我们在 sql_error 函数中进行错误处理. EXEC SQL create table t_emp as select empno,ename,sal from emp where 1

29、 = 0; coutTable T_EMP created.endl; /*下面在 main 函数内申明SQL宿主变量,这里的就是局部变量了,只能用在函数 main 内部以下申明了一些数组变量,供我们用来存储查询语句返回的多行数据,在 PL/SQL 中我们也曾使用bulk collect into 子句来批量 fetch 数据;当然我们也可以不定义数组,而定义单个变量,这样每次就只能获取一条数据. */ EXEC SQL BEGIN DECLARE SECTION; int empno5; /存放 EMPNO 字段 char ename511; /*存放 ENAME 字段,因为在 C 中字符串是要以 0 结尾的,所以比我们