本文主要是介绍OCI编程高级篇（十九） 创建和使用OCI连接池，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
上一节介绍了连接池的概念和使用连接池的步骤，这一节看看具体的操作是怎样的，先看一下用到的函数原型和参数。
创建连接池函数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。
前面是创建连接池和获取会话的函数，中间可以通过会话执行数据库操作的其他OCI函数。后面是释放会话和删除连接池的函数。
如果前面用了OCILogon2()函数来取得会话，那么要用OCILogoff()函数来释放会话。
sword OCILogoff ( OCISvcCtx *svchp, OCIError *errhp );
svchp是一个输入参数，服务上下文句柄，从OCILogon2()函数中返回的句柄。
errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。
如果前面使用了OCISessionGet()函数来获取会话，那么要用OCISessionRelease()函数来释放会话。
sword OCISessionRelease ( OCISvcCtx *svchp,
OCIError *errhp,
OraText *tag,
ub4 tag_len,
ub4 mode );
svchp是一个输入参数，服务上下文句柄，从OCISessionGet()函数中返回的句柄。
errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。
tag是一个输入参数，只用于会话池的参数，设置为NULL。
tag_len是一个输入参数，只用于会话池的参数，设置为0。
mode是一个输入参数，取值OCI_DEFAULT。
删除掉连接池，函数为OCIConnectionPoolDestroy()，原型和参数如下。
sword OCIConnectionPoolDestroy ( OCICPool *poolhp,
OCIError *errhp,
ub4 mode );
poolhp是一个输入参数，连接池句柄，与创建时的一致。
errhp是一个输入/输出参数，错误句柄，返回错误码和错误信息文本。
mode是一个输入参数，取值OCI_DEFAULT。
上面这些就是使用连接池时用到的函数，其他一些分配句柄函数OCIHandleAlloc()和设置属性函数OCIAttrSet()已经在前面介绍过了，这里从略。
下一节我们写一段代码，来看看使用连接池的整个过程。
这篇关于OCI编程高级篇（十九） 创建和使用OCI连接池的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
