OCCI使用指南OCCI编程模式Word文档格式.docx
- 文档编号:16719868
- 上传时间:2022-11-25
- 格式:DOCX
- 页数:23
- 大小:75.65KB
OCCI使用指南OCCI编程模式Word文档格式.docx
《OCCI使用指南OCCI编程模式Word文档格式.docx》由会员分享,可在线阅读,更多相关《OCCI使用指南OCCI编程模式Word文档格式.docx(23页珍藏版)》请在冰豆网上搜索。
参数说明:
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,
poolPassWord,
connectstring,
unsignedintminConn,
unsignedintmaxConn,
unsignedintincrConn);
poolUseName是连接池的用户名;
poolPassWord是连接数据库的密码;
connectstring是数据库连接串;
minConn是最小连接数;
maxConn是最大连接数;
incrConn是指所有已连接数处于繁忙中且小于最大连接数时,每次增加的连接数。
6.断开连接池
当对数据库操作完成之后,我们必须断开程序与数据库的连接,断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnectPool()函数。
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)”);
executeUpdate(“insertintostudent(sno,sname)values(1,’ZHANGSAN’)”);
executeQurey(“selectsnofromstudent”);
3.2.执行非查询语句
当我们创建了一个Statement对象stmt后,可以通过Statement类下的方法setSQL()为stmt设置不同的SQL语句。
3.2.1.准备SQL语句
stmt->
setSQL(string&
sql);
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等等。
setString(1,’zhangsan’);
指把’zhangsan’赋值给第一个参数,参数类型为字符串型。
setInt(2,1009);
指把1009赋值给第二个参数,参数类型为整型。
3.2.3.执行非查询语句
当SQL语句准备好后,就可以执行SQL语句了,方法如下所示:
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语句中的第几列,×
代表该列对应的类型。
rs->
next(unsignedintnumRows);
//其中numRows为批量处理的记录行数。
getInt(paramindex);
获取整型参数值,其中paramindex为参数所在的位置;
getString(paramindex);
获取字符型参数值其中paramindex为参数所在的位置;
3.4.输出参数声明
在调用存储过程时,有时候有返回参数,这些返回参数都必须在调用之前先用Statement类下的registerOutParam()方法声明,声明方法的使用如下所示:
registerOutParam(paramName,paramType,paramSize);
paramName是参数名或者参数所在位置;
paramType是参数类型(比如:
TYPE:
OCCIINT);
paramSize是参数的大小。
3.5.事务提交
3.5.1.手动提交
当事务的提交设置为手动时,每完成一个事务我们都必须调用Connection类下的commit()或rollback()方法来提交一个事务。
使用方法如下所示:
手动提交必须调用以下函数:
Connection:
commit();
rollback();
3.5.2.自动提交
在对数据库进行操作的过程中,一个事务的提交是用手动还是自动,我们可以调用Statement类下的setAutoCommit()方法来设置。
设置自动提交:
Statement:
setAutoCommit(TRUE);
设置手动提交:
setAutoCommit(FALSE);
4.OCCI常用类简要介绍
4.1.Environment类
Environment类提供了管理OCCI对象的内存及其它资源的一个环境,包含以下方法:
1.createConnection(conststringusename,conststringpassword,conststringconnstring);
指与数据库建立一个连接。
2.createConnectionPoll(
创建连接池。
poolPassWord是连接数据库的密码;
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&
赋一个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();
返回错误信息,没有则为空。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- OCCI 使用指南 编程 模式