OCCI使用指南OCCI编程模式.docx
《OCCI使用指南OCCI编程模式.docx》由会员分享，可在线阅读，更多相关《OCCI使用指南OCCI编程模式.docx（23页珍藏版）》请在冰豆网上搜索。
OCCI使用指南OCCI编程模式
1.OCCI编程模式
1.1.总体流程
编写OCCI程序的总体流程图，如下所示：
1.2.执行SQL语句的流程图
在OCCI中处理SELECT语句跟处理INSERT、UPDATE、CREATE等语句的方法是不一样的，其中SELECT语句是有返回结果，其它语句没有返回结果，所以必须区分SQL语句是否为查询语句，然后按照各自的流程处理。
流程图如下所示：
注：
标*号的过程为可选项
2.流程图具体说明
2.1.创建与终止OCCI环境变量
1.创建OCCI环境变量
Environment类是OCCI程序的基础类，所有的OCCI对象的建立都是依计Environment对象来创建的，所以Environment对象的建立必须放在第一位，而且也必须是最后一个被终止的。
例如：
首先创建一个Environment对象env，然后通过env创建一个Connection对象conn，conn是连接了数据库的对象；终止时，却反过来先终止对象conn，再终止对象env。
具体Environment对象的创建方法如下所示：
Environment*env=Environment:
:
createEnvironment（）;
注意：
createEnvironment（）方法有以下几个参数模式：
1．在线程环境中运行分为互斥线程（THREADEC_MUTEXED）、并行线程（THREADEC_UMMUTEXED）。
2．使用对象（OBJECT）。
3．利用共享数据结构（SHARED）。
2.终止OCCI环境变量
Environment对象的终止必须是放在最后一位，即等所有其它OCCI对象被终止完后再终止Environment对象。
终止Environment对象的方法如下所示：
Environment:
:
terminateEnvironment（env）;
2.2.连接与断开数据库
3.连接数据库
创建完一个Environment对象env后，可以调用Environment类下的方法createConnection（）来创建一个Connection对象conn；通过createConnection（）方法我们可以连接到任意一个数据库中。
连接数据库的具体方法如下所示：
Connection*conn=env->createConnection（usename,password,[connectionstring]）;
参数说明：
usename是登录数据库的用户名；
password是登录数据库用户的密码；
connectstingr是数据库的连接串（可选）。
4.断开数据库
当对数据库操作完成之后，我们必须断开程序与数据库的连接，断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnection（）函数。
方法如下所示：
env->terminateConnection（conn）;
2.3.创建与断开连接池
5.创建连接池
对于很多共享服务器或中间层应用程序而言，数据库的连接必须要能被许多线程所使用，如果为每个线程都开一个数据库连接的话，当数量一大效率会明显的降低，所以我们通过创建连接池来处理这样的情况。
创建完一个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是指所有已连接数处于繁忙中且小于最大连接数时，每次增加的连接数。
6.断开连接池
当对数据库操作完成之后，我们必须断开程序与数据库的连接，断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnectPool（）函数。
方法如下所示：
env->terminateConnectPool（connPoll）;
2.4.创建与终止Statement对象
2.4.1.创建Statement对象
Statement类包含了执行SQL语句的所有方法，是对数据库操作的具体实现。
Statement对象stmt的创建是通过调用Connection类下的createStatement（）函数实现，所以Statement对象的创建必须是在Connection对象创建之后。
createStatement（）函数可以带参数或不带参数，如果带参数的话，参数必须是一个SQL语句；如果没有带参数，则在后面必须用Statement类下setSQL（）函数为Statement对象赋一个SQL语句。
Statement对象的创建方法如下所示：
Statement*stmt=conn->createStatement（）;
7.终止Statement对象
当对数据库的操作完成时，我们必须先终止Statement对象，再断开Connection对象。
终止Statement对象的方法如下所示：
Conn->terminateStatement（stmt）;
3.执行SQL语句（Statement类）
3.1.执行SQL语句的方法
执行SQL的所有方法都包含在Statement类下。
SQL语句按返回结果分，可以分为两种：
一种是有返回值的（查询语句），另外一种是没有返回值的（非查询语句）。
一般情况下，在执行查询SQL语句我们使用executeQurey（）函数，在执行非查询SQL语句时我们使用executeUpdate（）函数。
1．stmt->execute（）;执行所有非特殊声明的SQL语句。
2．stmt->executeUpdate（）;执行所有DDL和DML（一条记录）的SQL语句。
3．stmt->executeQurey（）;执行所有查询SQL语句。
4．stmt->executeArrayUpdate（）;执行多记录的DML的SQL语句。
例如：
stmt->executeUpdate（“createtablestudent（snonumber（10）,snamevarchar2）”）；
stmt->executeUpdate（“insertintostudent（sno,sname）values（1,’ZHANGSAN’）”）;
stmt->executeQurey（“selectsnofromstudent”）;
3.2.执行非查询语句
当我们创建了一个Statement对象stmt后，可以通过Statement类下的方法setSQL（）为stmt设置不同的SQL语句。
3.2.1.准备SQL语句
stmt->setSQL（string&sql）；
例如：
stmt->setSQL（“insertintostudent（sno,sname）values（:
1,:
2）”）
其中：
:
1、:
2是参数，通过给参数赋不同的值来实现。
与之对应的函数getSQL（）是取出当前对象对应的SQL语句。
3.2.2.绑定输入参数值
在Statement类中包含了所有参数的赋值方法，赋值方法set×××（unsignedintparamindex,typevalues）,其中paramindex参数是代表所赋值参数在SQL语句中的第几个参数，×××与type代表中所赋值的类型，values是所赋的值。
×××可以是Int、String、Date等等。
例如：
stmt->setString（1,’zhangsan’）；指把’zhangsan’赋值给第一个参数，参数类型为字符串型。
stmt->setInt（2,1009）;指把1009赋值给第二个参数，参数类型为整型。
3.2.3.执行非查询语句
当SQL语句准备好后，就可以执行SQL语句了，方法如下所示：
stmt->executeUpdate（）;
3.3.执行查询语句（SELECT）
在执行查询语句时有返回查询结果（可能是一条，也可能是多条），我们必须创建一个ResultSet对象来处理，通过使用ResultSet对象的next（）方法我们可以一条一条（或批量）地处理结果集。
具体使用如下所示：
3.3.1.准备SQL语句
详见3.2.1。
3.3.2.绑定输入参数值
详见3.2.2。
3.3.3.执行查询语句
ResultSet*rs=stmt->executeQuery（）;
3.3.4.定义输出变量
根据SELECT语句查询的列的类型定义对应的变量，此变量用于存储SELECT查询的结果集。
3.3.5.推进或处理数据
如果结果集为多条记录，我们可以批量或者一条条处理数据，使用ResultSet类下的方法next（unsignedintnumRows）。
在Statement类中包含了所有参数的取值方法。
取值方法get×××（unsignedintparamindex），其中paramindex参数是代表所取值列在SQL语句中的第几列，×××代表该列对应的类型。
×××可以是Int、String、Date等等。
例如：
rs->next（unsignedintnumRows）;//其中numRows为批量处理的记录行数。
stmt->getInt（paramindex）;获取整型参数值,其中paramindex为参数所在的位置；
stmt->getString（paramindex）;获取字符型参数值其中paramindex为参数所在的位置；
3.4.输出参数声明
在调用存储过程时，有时候有返回参数，这些返回参数都必须在调用之前先用Statement类下的registerOutParam（）方法声明，声明方法的使用如下所示：
stmt->registerOutParam（paramName,paramType,paramSize）;
其中：
paramName是参数名或者参数所在位置；
paramType是参数类型（比如：
TYPE:
:
OCCIINT）；
paramSize是参数的大小。
3.5.事务提交
3.5.1.手动提交
当事务的提交设置为手动时，每完成一个事务我们都必须调用Connection类下的commit（）或rollback（）方法来提交一个事务。
使用方法如下所示：
手动提交必须调用以下函数：
Connection:
:
commit（）;
Connection:
:
rollback（）;
3.5.2.自动提交
在对数据库进行操作的过程中，一个事务的提交是用手动还是自动，我们可以调用Statement类下的setAutoCommit（）方法来设置。
使用方法如下所示：
设置自动提交：
Statement:
:
setAutoCommit（TRUE）;
设置手动提交：
Statement:
:
setAutoCommit（FALSE）;
4.OCCI常用类简要介绍
4.1.Environment类
Environment类提供了管理OCCI对象的内存及其它资源的一个环境,包含以下方法：
1．createConnection（conststringusename,conststringpassword,conststringconnstring）;指与数据库建立一个连接。
2．createConnectionPoll（
conststring&poolUseName,
conststring&poolPassWord,
conststring&connectstring,
unsignedintminConn,
unsignedintmaxConn,
unsignedintincrConn）;创建连接池。
参数说明：
poolUseName是连接池的用户名；
poolPassWord是连接数据库的密码；
connectstring是数据库连接串；
minConn是最小连接数；
maxConn是最大连接数；
incrConn是指所有已连接数处于繁忙中且小于最大连接数时，每次增加的连接数。
3．createEnironment（Modemode）;创建一个环境对象，其中mode是模式（可选DEFAULT、THREADED_MUTEXED、THREADED_UN-MUTEXED、OBJECT、SHARED值）。
4．getCurrentHeapSize（）;指在同一环境下已经分配的内存数。
5．getOCIEnironment（）;返回一个OCI环境指针。
6．terminateConnection（Connection*conn）;断开与数据库的连接。
7．terminateConnection（ConnectionPool*poolconn）;断开与数据库的连接池。
8．terminateEnironment（Einironment*env）;终止OCCI环境变量。
4.2.Connection类
Connection类提供了C++程序与指定数据库的连接，包含以下方法：
1．changePassword（conststring&user,conststring&oldPassword,conststring&newPassword）;改变当前用户的密码。
2．Commit（）;提交事务。
3．createStatement（conststring&sql=””）;创建一个Statement对象。
4．flushCache（）;
5．rollback（）;事务的回滚。
6．terminateStatement（Statement*stmt）.终止一个Statement对象，并释放它占有的所有资源。
4.3.ConnectionPool类
ConnectionPoll类提供了C++程序与指定数据库间的连接池，包含以下方法：
1．createConnection（conststring&username,conststring&password）;创建一个连接。
2．getBusyConnections（）;返回连接池中被占用的连接数量。
3．getMaxConnections（）;返回连接池的最大连接数。
4．getMinConnections（）;返回连接池的最小连接数。
5．getOpenConnections（）;返回连接池中已经被打开的连接数。
6．getPollName（）;返回连接池的名称。
7．getTimeOut（）;返回连接池的超时时间。
8．setErrorOnBusy（）;设置异常，当连接池处于繁忙或达到最大连接数后。
9．serPoolSize（unsignedintminConn,unsignedintmaxConn,unsignedintincrConn）;设置连接池的大小，其中参数minConn是最小连接数，maxConn是最大连接数，incrConn是递增连接数。
10．setTimeOut（）;设置超时时间。
11．terminateConnection（Connection*conn）;断开连接。
4.4.Statement类
Statement对象主要被用来执行SQL语句，它可以运行一个查询语句返回一个结果集也可以运行UPDATE、DELETE等SQL语句。
1．addIteration（）;增加一个循环。
2．closeResultSet（ResultSet*rs）;关闭一个结果集。
3．closeStream（Stream*stream）;关闭一个已定义的流。
4．execute（conststring&sql=“”）;执行一个SQL语句，如果前面使用的setSQL（）方法，则参数sql可以为空。
5．executeArrayUpdate（unsignedintarrayLength）;同时修改多条记录，前面必须使用了setDataBuffer（）方法设置一个数量或设置了一个流（stream）。
6．executeQuery（）;执行一个查询语句。
7．executeUpdate（）;执行DDL、DML语句，如：
INSERT、UPDATE、DELETE、CREATE等等。
8．getAutoCommit（）;返回是否事务自动提交。
9．getDate（unsignedintparamindex）;返回DATE型数据。
10．getDouble（unsignedintparamindex）;返回DOUBLE型数据。
11．getFloat（unsignedintparamindex）;返回FLOAT型数据。
12．getInt（unsignedintparamindex）;返回INT型数据。
13．getNumber（unsignedintparamindex）;返回NUMBER型数据。
14．getRef（unsignedintparamindex）;返回REF参数值。
15．getResultSet（）;得到一个结果集（ResultSet）。
16．getSQL（）;返回当前的SQL语句。
17．getString（unsignedintparamindex）;返回STRING型数据。
18．getUpdateCount（）;返回被更新的数量。
19．isNull（unsignedintparamindex）;判断第X个值是否为空。
20．isTruncated（unsignedintparamindex）;判断第X个值是否被截取。
21．setAutoCommit（boolautocommit）;设置事务是否自动提交。
22．setDouble（unsignedintparamindex,doublex）;赋一个double型的值。
23．setFloat（unsignedintparamindex,floatx）;赋一个float型的值。
24．setInt（unsignedintparamindex,intx）;赋一个INT型的值。
25．setNull（unsignedintparamindex,TYPEtype）;某参数设置为空。
26．setNumber（unsignedintparamindex,constnumber&x）;赋一个Number型的值。
27．setObject（unsignedintparamindex,PObject*x）;赋一个PObject型的值。
28．setString（unsignedintparamindex,conststring&x）;赋一个string型的值。
29．setSQL（conststring&sql）;设置一个SQL语句。
30．Status（）;返回当前的状态。
4.5.ResultSet类
ResultSet类是查询数据表的结果集，它包含以下方法：
1．cancel（）;取消结果集。
2．closeStream（Stream*stream）;关闭一个流。
3．getDouble（unsignedintcolIndex）;返回double型的值。
4．getFloat（unsignedintcolIndex）;返回float型的值。
5．getInt（unsignedintcolIndex）;返回int型的值。
6．getMaxColumnSize（unsignedintcolIndex）;返回某列包含的数据量。
7．getNumber（unsignedintcolIndex）;返回number型的数据。
8．getPObject（unsignedintcolIndex）;返回PObject型的数据。
9．getRowid（unsignedintcolIndex）;返回rowid值。
10．getString（unsignedintcolIndex）;返回string型的数据。
11．isNull（unsignedintcolIndex）;判断值是否为空。
12．isTruncated（unsignedintcolIndex）;判断值是否被删。
13．next（unsignedintnumRows）;取下numRows条记录。
14．status（）;返回当前状态。
4.6.PObject类
PObject类包含以下方法：
1．fush（）;
2．Connection*getConnection（）;从一个实例化的永久对象中返回连接。
3．isLocked（）;判断永久对象是否被锁（TRUE或FALSE）。
4．isNull（）;判断永久对象是否为空（TRUE或FALSE）。
5．Lock（PObject:
:
LockOptionlock_option）;在数据库中锁住一个对象，其中lock_option取值为OCCI_LOCK_WAIT、OCCI_LOCK_NOWAIT。
6．markDelete（）;删除数据库中的永久对象。
7．markModified（）;修改永久对象。
8．PObject&operator（constPObject&obj）;赋值（对象）。
9．operatordelete（void*obj,size_tsize）;删除对象，但不能删除数据库中的对象。
10．*operatornew（size_tsize）;创建临时对象。
11．*operatornew（size_tsize,constConnection*x,conststring&tablename,constchar*type_name）;创建永久对象。
12．pin（）;
13．setNull（）;设置对象为空。
14．unmark（）;不标记永久对象为删除或修改。
15．unpin（UnpinOptionmode）;其中，mode的取值为OCCI_PINCOUNT_RESET、OCCI_PINCOUNT_DECR。
4.7.SQLException类
SQLException类提供错误代码及其错误信息，包含以下方法：
1．getErrorCode（）;返回数据库中的错误编码。
2．getMessage（）;返回错误信息，没有则为空。
升级会员 