oci编程示例讲解.pdf

### OCI编程示例详解 #### 一、OCI简介 Oracle Call Interface (OCI) 是 Oracle 提供的一套 C/C++ 库接口，用于实现应用程序与 Oracle 数据库之间的交互。OCI 支持多种高级特性，如事务处理、大对象支持、安全模型等。本文档通过具体的示例来讲解 OCI 的基本编程流程。 #### 二、初始化OCI程序环境 在使用 OCI 与 Oracle 数据库建立会话之前，必须先初始化 OCI 程序环境。这一步骤对于后续的所有操作至关重要。 ##### 1. **函数原型** ```c sword OCIInitialize( ub4 mode, CONST dvoid *ctxp, CONST dvoid *(*malocfp)(/*dvoid*ctxp,size_t size_*/), CONST dvoid *(*ralocfp)(/*_dvoid*ctxp,dvoid*memptr,size_t newsize_*/), CONST void (*mfreefp)(/*_dvoid*ctxp,dvoid*memptr_*/) ); ``` ##### 2. **参数说明** - `mode`: 初始化模式。可选值包括： - `OCI_DEFAULT`: 缺省模式。 - `OCI_THREADED`: 多线程模式。在此模式下，各并发处理中的内部数据结构受到各自线程的保护，不受其他线程的影响。 - `OCI_OBJECT`: 使用对象特性。 - `OCI_SHARED`: 使用共享内存。 - `OCI_EVENTS`: 事件模式。 - `*ctxp`: 用户定义的内存回调程序；默认为 0。 - `*(*malocfp)`: 用户定义的内存分配程序；默认为 0。 - `*(*ralocfp)`: 内存重新分配程序；默认为 0。 - `*memptr`: 指向内存块的指针。 - `*mfreefp`: 用户定义的内存释放程序；默认为 0。 ##### 3. **函数使用示例** ```c OCIInitialize((ub4)OCI_THREADED | OCI_OBJECT, (dvoid*)0, (dvoid*(*)(dvoid*, size_t))0, (dvoid*(*)(dvoid*, dvoid*, size_t))0, (void(*)(dvoid*, dvoid*))0); ``` **注意**：`OCIEnvCreate()` 函数也可以替代 `OCIInitialize()` 和 `OCIEnvInit()` 进行初始化。 #### 三、初始化OCI环境句柄 初始化环境句柄是使用 OCI 的另一个重要步骤，通常在初始化程序环境之后调用。 ##### 1. **函数原型** ```c sword OCIEnvInit( OCIEnv **envhpp, ub4 mode, size_txtramemsz, dvoid **usrmempp ); ``` ##### 2. **参数说明** - `**envhpp`: 指向环境句柄的指针。 - `mode`: 初始化环境句柄的模式。可能的值包括： - `OCI_DEFAULT`: 缺省模式。 - `OCI_NO_MUTEX`: 非互斥模式。 - `OCI_ENV_NO_UCB`: 禁止回滚模式，用于禁止环境句柄初始化过程中的动态CALL_BACK函数调用。 - `xtramemsz`: 指定在环境句柄生命周期内分配内存的数量。 - `**usrmempp`: 指向 `xtramemsz` 参数的指针。 ##### 3. **函数使用示例** ```c OCIEnvInit((OCIEnv **)envhp, (ub4)OCI_DEFAULT, (size_t)0, (dvoid **)0); ``` #### 四、分配各OCI句柄 在建立 OCI 连接之前，还需要分配所需的句柄，包括服务句柄、错误句柄、会话句柄、服务器句柄和陈述句柄等。 ##### 1. **函数原型** ```c sword OCIHandleAlloc( CONST dvoid *parenth, dvoid **hndlpp, ub4 type, size_txtramem_sz, dvoid **usrmempp ); ``` ##### 2. **参数说明** - `*parenth`: 已初始化的环境句柄。 - `**hndlpp`: 成功执行后返回的 OCI 句柄。 - `type`: 返回句柄的类型。常用的类型有： - `OCI_HTYPE_SVCCTX`: 服务句柄。 - `OCI_HTYPE_ERROR`: 错误句柄。 - `OCI_HTYPE_SESSION`: 会话句柄。 - `OCI_HTYPE_SERVER`: 服务器句柄。 - `OCI_HTYPE_STMT`: 陈述句柄（用于对数据库进行操作）。 - `xtramem_sz`: 指定在句柄生命周期内分配内存的数量。 - `**usrmempp`: 指向 `xtramem_sz` 参数的指针。 #### 总结 本文档详细介绍了使用 OCI 进行 Oracle 数据库编程的基本步骤。这些步骤包括了初始化程序环境、初始化环境句柄以及分配各种句柄。了解并掌握这些基本步骤对于开发基于 Oracle 数据库的应用程序至关重要。希望本文档能帮助开发者更好地理解和使用 OCI。