第一章 OCCI 中文编程指南.doc

OCCI编程模式 总体流程图 编写OCCI程序的总体流程图，如下所示： 执行SQL语句的流程图 在OCCI中处理SELECT语句跟处理INSERT、UPDATE、CREATE等语句的方法是不一样的，其中SELECT语句是有返回结果，其它语句没有返回结果，所以必须区分SQL语句是否为查询语句，然后按照各自的流程处理。流程图如下所示： 注：标*号的过程为可选项 流程图具体说明 创建与终止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( const string poolUseName, const string poolPassWord, const string connectstring, unsigned int minConn, unsigned int maxConn, unsigned int incrConn); 参数说明：poolUseName是连接池的用户名； poolPassWord是连接数据库的密码； connectstring是数据库连接串； minConn是最小连接数； maxConn是最大连接数； incrConn是指所有已连接数处于繁忙中且小于最大连接数时，每次增加的连接数。 断开连接池 当对数据库操作完成之后，我们必须断开程序与数据库的连接，断开数据库的连接方法与创建的方法一样来自Environment类下的terminateConnectPool()函数。方法如下所示： env-terminateConnectPool(connPoll); 创建与终止Statement对象 创建Statement对象 Statement类包