OCCI-中文编程指南

1.OCCI编程模式1.1.总体流程图编写OCCI程序的总体流程图，如下所示：开始创建环境变量创建数据库连接对象创建Statement类对象执行SQL语句处理数据释放Statement对象断开数据库连接释放环境变量结束1.2.执行SQL语句的流程图在OCCI中处理SELECT语句跟处理INSERT、UPDATE、CREATE等语句的方法是不一样的，其中SELECT语句是有返回结果，其它语句没有返回结果，所以必须区分SQL语句是否为查询语句，然后按照各自的流程处理。流程图如下所示：准备SQL语句绑定参数*执行SQL语句定义输出变量*推进和处理数据*注：标*号的过程为可选项2.流程图具体说明2.1.创建与终止OCCI环境变量创建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）。终止OCCI环境变量Environment对象的终止必须是放在最后一位，即等所有其它OCCI对象被终止完后再终止Environment对象。终止Environment对象的方法如下所示：Environment::terminateEnvironment(env);2.2.连接与断开数据库连接数据库创建完一个Environment对象env后，可以调用Environment类下的方法createConnection()来创建一个Connection对象conn；通过createConnection()方法我们可以连接到任意一个数据库中。连接数据库的具体方法如下所示：Connection*conn=env-createConnection(usename,password,[connectionstring]);参数说明：usename是登录数据库的用户名；password是登录数据库用户的密码；connectstingr是数据库的连接串(可选)。断开数据库当对数据库操作完成之后，我们必须断开程序与数据库的连接，断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnection()函数。方法如下所示：env-terminateConnection(conn);2.3.创建与断开连接池创建连接池对于很多共享服务器或中间层应用程序而言，数据库的连接必须要能被许多线程所使用，如果为每个线程都开一个数据库连接的话，当数量一大效率会明显的降低，所以我们通过创建连接池来处理这样的情况。创建完一个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);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();终止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&connectstr