上一节介绍了连接池的概念和使用连接池的步骤,这一节看看具体的操作是怎样的,先看一下用到的函数原型和参数。
创建连接池函数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()已经在前面介绍过了,这里从略。
下一节我们写一段代码,来看看使用连接池的整个过程。