OCI编程高级篇（十九）创建和使用OCI连接池

最新推荐文章于 2024-09-06 14:12:06 发布

tomcoding

最新推荐文章于 2024-09-06 14:12:06 发布

阅读量766

点赞数 16

文章标签：数据库 oracle 数据库开发

本文链接：https://blog.csdn.net/tomcoding/article/details/141903072

版权

上一节介绍了连接池的概念和使用连接池的步骤，这一节看看具体的操作是怎样的，先看一下用到的函数原型和参数。

创建连接池函数OCIConnectionPoolCreate()，原型和参数如下。

sword OCIConnectionPoolCreate ( OCIEnv *envhp,
OCIError *errhp,
OCICPool *poolhp,
OraText **poolName,
sb4 *poolNameLen,
const OraText *dblink,
sb4 dblinkLen,
ub4 connMin,
ub4 connMax,
ub4 connIncr,
const OraText *poolUsername,
sb4 poolUserLen,
const OraText *poolPassword,
sb4 poolPassLen,
ub4 mode );

envhp是一个输入参数，OCI环境句柄。

errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。

poolhp是一个输入参数，连接池句柄，调用函数前要先分配一个，父句柄是envhp。

poolName是一个输出参数，返回连接池的名称，后面的函数会用到。

poolNameLen是一个输出参数，返回连接池名称的长度，后面的函数会用到。

dblink是一个输入参数，连接数据库的连接字符串，可以是TNS名称。

dblinkLen是一个输入参数，连接字符串的长度。

connMin是一个输入参数，与后面的两个参数一起决定连接池到数据库的连接个数，这个是连接池创建时与数据库建立的最小连接数，最小可以是0，有用户请求时再创建。

connMax是一个输入参数，限制连接池与数据库的最大连接数。

connIncr是一个输入参数，表示连接达到最小值，有新连接请求时每次增长的连接个数。

poolUsername是一个输入参数，连接池会隐含的开启一个与数据库的会话，这是会话认证时的用户名称。

poolUserLen是一个输入参数，认证用户名称的长度。

poolPassword是一个输入参数，认证用户的密码。

poolPassLen是一个输入参数，密码长度。

mode是一个输入参数，一般选择OCI_DEFAULT。

获取连接池的会话函数，有两个可用一个是OCILogon2()，另一个是OCISessionGet()。先看第一个。

sword OCILogon2 ( OCIEnv *envhp,
OCIError *errhp,
OCISvcCtx **svchp,
const OraText *username,
ub4 uname_len,
const OraText *password,
ub4 passwd_len,
const OraText *dbname,
ub4 dbname_len );
ub4 mode );

envhp是一个输入参数，OCI环境句柄。

errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。

svchp是一个输入/输出参数，服务上下文句柄。这个句柄不需要分配，OCI会自动分配这个句柄，函数还会自动分配一个服务器句柄和开启一个会话句柄，并且把这两个句柄设置到服务上下文句柄的属性中。

username是一个输入参数，用于会话认证的用户名。

uname_len是一个输入参数，认证用户的长度。

password是一个输入参数，认证用户的密码。

passwd_len是一个输入参数，认证密码长度。

dbname是一个输入参数，在这里要输入连接池的名称。

dbname_len是一个输入参数，连接池名称的长度。

mode是一个输入参数，这里要选择OCI_LOGON2_CPOOL。

另一个函数是OCISessionGet()，这个函数传入一个认证信息句柄，可以更细致的控制认证过程。

sword OCISessionGet ( OCIenv *envhp,
OCIError *errhp,
OCISvcCtx **svchp,
OCIAuthInfo *authInfop,
OraText *dbName,
ub4 dbName_len,
const OraText *tagInfo,
ub4 tagInfo_len,
OraText **retTagInfo,
ub4 *retTagInfo_len,
boolean *found,
ub4 mode );

envhp是一个输入/输出参数，OCI环境句柄。

errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。

svchp是一个输入参数，服务上下文句柄。这个句柄不需要分配，OCI会自动分配这个句柄，函数还会自动分配一个服务器句柄和开启一个会话句柄，并且把这两个句柄设置到服务上下文句柄的属性中。

authInfop是一个输入参数，认证信息句柄，要预先分配，父句柄是envhp，使用OCI_HTYPE_AUTHINFO类型，分配句柄后要设置认证用户和密码的属性。

dbName是一个输入参数，连接池名称，创建连接池时返回。

dbName_len是一个输入参数，连接池名称长度。

tagInfo是一个输入参数，会话标签信息，只用于会话池的参数，设置为NULL。

tagInfo_len是一个输入参数，会话标签信息长度。

retTagInfo是一个输出参数，返回的会话标签信息，指示会话的类型，只用于会话池的参数，设置为NULL。

retTagInfo_len是一个输出参数，返回的会话标签信息长度。

found是一个输出参数。用于会话池的参数，设置为NULL。

mode是一个输入参数，取值OCI_SESSGET_CPOOL。