文档介绍：该【OCCI 中文编程指南】是由【guoxiachuanyue001】上传分享，文档一共【21】页，该文档可以免费在线阅读，需要了解更多关于【OCCI 中文编程指南】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。

编写OCCI程序的总体流程图,如下所示:
创建环境变量
创建数据库连
接对象
创建Statement
类对象
执行SQL语句处
理数据
释放Statement
对象
断开数据库连
接
12执行SQL语句的流程图
在OCCI中处理SELECT语句跟处理INSERT、UPDATE、CREATE等语句的方法是不一样的,其中SELECT语句是有返回结果,其它语句没有返回结果,所以必须区分SQL语句是否为查询语句,然后按照各自的流程处理。流程图如下所示:
注:标*号的过程为可选项

2・1■创建与终止OCCI环境变量
创建OCCI环境变量
Environment类是OCCI程序的基础类,所有的OCCI对象的建立都是依计Environment对象来创建的,所以Environment对象的建立必须放在第一位,而且也必须是最后一个被终止的。例如:首先创建一个Environment对象env,然后通过env创建一个Connection对象conn,conn是连接了数据库的对象;终止时,却反过来先终止对象conn,再终止对象env。具体Environment对象的创建方法如下所示:
Environment*env=Environment::createEnvironment();
注意:createEnvironment()方法有以下几个参数模式:
(THREADEC_MUTEXED)、并行线程(THREADEC_UMMUTEXED)。
使用对象(OBJECT)。
利用共享数据结构(SHARED)。
终止OCCI环境变量
Environment对象的终止必须是放在最后一位,即等所有其它OCCI对象被终止完后再终止Environment对象。终止Environment对象的方法如下所示:
Environment::terminateEnvironment(env);
连接与断开数据库
连接数据库
创建完一个Environment对象env后,可以调用Environment类下的方法createConnection()来创建一个Connection对象conn;通过createConnection()方法我们可以连接到任意一个数据库中。连接数据库的具体方法如下所示:
Connection*conn=env->createConnection(usename,password,[connectionstring]);
参数说明:usename是登录数据库的用户名;
password是登录数据库用户的密码;connectstingr是数据库的连接串(可选)。
断开数据库
当对数据库操作完成之后,我们必须断开程序与数据库的连接,断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnection()函数。方法如下所示:
env->terminateConnection(conn);
创建与断开连接池
创建连接池
对于很多共享服务器或中间层应用程序而言,数据库的连接必须要能被许多线程所使用,如果为每个线程都开一个数据库连接的话,当数量一大效率会明显的降低,所以我们通过创建连接池来处理这样的情况。创建完一个Environment对象env后,可以调用Environment类下的方法createConnectionPool()来创建一个Connection对象connPool;通过
createConnectionPool()方法我们可以连接到任意一个数据库中。连接池创建的具体方法如下所示:
ConnectionPool*connPool=env->createConnectionPool(
conststring&poolUseName,conststring&poolPassWord,conststring&connectstring,unsignedintminConn,
unsignedintmaxConn,
unsignedintincrConn);
参数说明:poolUseName是连接池的用户名;
poolPassWord是连接数据库的密码;connectstring是数据库连接串;minConn是最小连接数;maxConn是最大连接数;incrConn是指所有已连接数处于繁忙中且小于最大连接数时,每次增加的连接数。
断开连接池
当对数据库操作完成之后,我们必须断开程序与数据库的连接,断开数据库的连接方法
与创建的方法一样来自Environment类下的terminateConnectPool()函数。方法如下所示:
env->terminateConnectPool(connPoll);

创建Statement对象
Statement类包含了执行SQL语句的所有方法,是对数据库操作的具体实现。Statement对象stmt的创建是通过调用Connection类下的createStatement()函数实现,所以Statement对象的创建必须是在Connection对象创建之后。createStatement()函数可以带参数或不带参数,如果带参数的话,参数必须是一个SQL语句;如果没有带参数,则在后面必须用Statement类下setSQL()函数为Statement对象赋一个SQL语句。Statement对象的创建方法如下所示:
Statement*stmt=conn->createStatement();
终止Statement对象
当对数据库的操作完成时,我们必须先终止Statement对象,再断开Connection对象。终止Statement对象的方法如下所示:
Conn->terminateStatement(stmt);
(Statement类)
执行SQL语句的方法
执行SQL的所有方法都包含在Statement类下。SQL语句按返回结果分,可以分为两种:一种是有返回值的(查询语句),另外一种是没有返回值的(非查询语句)。一般情况下,在执行查询SQL语句我们使用executeQurey()函数,在执行非查询SQL语句时我们使用executeUpdate()函数。
stmt->execute();执行所有非特殊声明的SQL语句。
stmt->executeUpdate();执行所有DDL和DML(一条记录)的SQL语句。
stmt->executeQurey();执行所有查询SQL语句。
stmt->executeArrayUpdate();执行多记录的DML的SQL语句。例如:
stmt->executeUpdate(“createtablestudent(snonumber(10),snamevarchar2)”);stmt->executeUpdate(“insertintostudent(sno,sname)values(1,'ZHANGSAN')”);stmt->executeQurey(“selectsnofromstudent”);
执行非查询语句
当我们创建了一个Statement对象stmt后,可以通过Statement类下的方法setSQL()为stmt设置不同的SQL语句。

stmt->setSQL(string&sql);例如:
stmt->setSQL(“insertintostudent(sno,sname)values(:1,:2)”)
其中::1、:2是参数,通过给参数赋不同的值来实现。
与之对应的函数getSQL()是取出当前对象对应的SQL语句。
绑定输入参数值
在Statement类中包含了所有参数的赋值方法,赋值方法setXXX(unsignedint
paramindex,typevalues),其中paramindex参数是代表所赋值参数在SQL语句中的第几个参数,XXX与type代表中所赋值的类型,values是所赋的值。XXX可以是Int、String、Date例如:
stmt->setString(l,'zhangsan');指把'zhangsan'赋值给第一个参数,参数类型为字符串型。stmt->setInt(2,1009);指把1009赋值给第二个参数,参数类型为整型。
执行非查询语句
当SQL语句准备好后,就可以执行SQL语句了,方法如下所示:
stmt->executeUpdate();
(SELECT)
在执行查询语句时有返回查询结果(可能是一条,也可能是多条),我们必须创建一个
ResultSet对象来处理,通过使用ResultSet对象的next()方法我们可以一条一条(或批量)地处理结果集。具体使用如下所示:
3・3・1・准备SQL语句
。
3・3・2・绑定输入参数值
。
3・3・3・执行查询语句
ResultSet*rs=stmt->executeQuery();
定义输出变量
根据SELECT语句查询的列的类型定义对应的变量,此变量用于存储SELECT查询的结果集。
推进或处理数据
如果结果集为多条记录,我们可以批量或者一条条处理数据,使用ResultSet类下的方法next(unsignedintnumRows)。
在Statement类中包含了所有参数的取值方法。取值方法getXXX(unsignedintparamindex),其中paramindex参数是代表所取值列在SQL语句中的第几列,XXX代表该列对应的类型°XXX可以是Int、String、Date等等。
例如:
rs->next(unsignedintnumRows);//其中numRows为批量处理的记录行数。
stmt->getInt(paramindex);获取整型参数值,其中paramindex为参数所在的位置;stmt->getString(paramindex);获取字符型参数值其中paramindex为参数所在的位置;
输出参数声明
在调用存储过程时,有时候有返回参数,这些返回参数都必须在调用之前先用Statement类下的registerOutParam()方法声明,声明方法的使用如下所示:
stmt->registerOutParam(paramName,paramType,paramSize);
其中:paramName是参数名或者参数所在位置;
paramType是参数类型(比如:TYPE::OCCIINT);paramSize是参数的大小。
事务提交

当事务的提交设置为手动时,每完成一个事务我们都必须调用Connection类下的commit()或rollback)方法来提交一个事务。使用方法如下所示:
手动提交必须调用以下函数:
Connection::commit();
Connection::rollback();

在对数据库进行操作的过程中,一个事务的提交是用手动还是自动,我们可以调用
Statement类下的setAutoCommit()方法来设置。使用方法如下所示:
设置自动提交:
Statement::setAutoCommit(TRUE);
设置手动提交:
Statement::setAutoCommit(FALSE);

Environment类
Environment类提供了管理OCCI对象的内存及其它资源的一个环境,包含以下方法:
(conststringusename,conststringpassword,conststringconnstring);扌旨与数
据库建立一个连接。
(
unsignedintunsignedintunsignedint
minConn,
maxConn,incrConn);创建连接池。
string&poolUseName,string&poolPassWord,string&connectstring,
参数说明:poolUseName是连接池的用户名;
constconstconst
poolPassWord是连接数据库的密码;connectstring是数据库连接串;
minConn是最小连接数;
maxConn是最大连接数;
incrConn是指所有已连接数处于繁忙中且小于最大连接数时,每次增加的连接数。
(Modemode);创建一个环境对象,其中mode是模式(可选DEFAULT、
THREADED_MUTEXED、THREADED_UN-MUTEXED、OBJECT、SHARED值)。
getCurrentHeapSize();指在同一环境下已经分配的内存数。
getOCIEnironment();返回一个OCI环境指针。
terminateConnection(Connection*conn);断开与数据库的连接。
terminateConnection(ConnectionPool*poolconn);断开与数据库的连接池。
terminateEnironment(Einironment*env);终止OCCI环境变量。
Connection类
Connection类提供了C++程序与指定数据库的连接,包含以下方法:
(conststring&user,conststring&oldPassword,conststring&newPassword);改变当前用户的密码。
Commit。;提交事务。
createStatement(conststring&sql="");创建一个Statement对象。
();
rollback。;事务的回滚。
terminateStatement(Statement*stmt)终止一个Statement对象,并释放它占有的所有资源。
ConnectionPool类
ConnectionPoll类提供了C++程序与指定数据库间的连接池,包含以下方法:
createConnection(conststring&username,conststring&password);创建一个连接。
getBusyConnections();返回连接池中被占用的连接数量。
getMaxConnections();返回连接池的最大连接数。
getMinConnections();返回连接池的最小连接数。
getOpenConnections();返回连接池中已经被打开的连接数。
getPollName();返回连接池的名称。
getTimeOut();返回连接池的超时时间。
setErrorOnBusy();设置异常,当连接池处于繁忙或达到最大连接数后。
serPoolSize(unsignedintminConn,unsignedintmaxConn,unsignedintincrConn);设置连接池的大小,其中参数minConn是最小连接数,maxConn是最大连接数,incrConn是递增连接数。
setTimeOut();设置超时时间。
terminateConnection(Connection*conn);断开连接。

Statement对象主要被用来执行SQL语句,它可以运行一个查询语句返回一个结果集也可以运行UPDATE、DELETE等SQL语句。
.addIteration();增加一个循环。
.closeResultSet(ResultSet*rs);关闭一个结果集。
.closeStream(Stream*stream);关闭一个已定义的流。
.execute(conststring&sql=“”);执行一个SQL语句,如果前面使用的setSQL()方法,则参
数sql可以为空。
.executeArrayUpdate(unsignedintarrayLength);同时修改多条记录,前面必须使用了
setDataBuffer()方法设置一个数量或设置了一个流(stream)。
.executeQuery();执行一个查询语句。
.executeUpdate();执行DDL、DML语句,如:INSERT、UPDATE、DELETE、CREATE