ORACLE数据库API接口函数设计说明

本文格式为Word版，下载可任意编辑——ORACLE数据库API接口函数设计说明ORACLE数据库API接口函数设计说明

API接口函数使用例如：参见程序OCIDEMO.DSW

//工程中不用在连接ociw32.lib只用xjoci.lib就行了。假定:

工程文件为newocidemo,所在目录为c:\\newocidemo,newocidemo.exe位于c:\\newocidemo\\debug下面使用步骤：

1、将MyConnection.h;oratypes.h;ocidem.h;ocidfn.h;xioci.lib复制到c:\\newocidemo下面

2、将xioci.dll复制到c:\\newocidemo\\debug下面

3、设置project下的settings下面的link中的object/librarymodules:为xjoci.lib

4、在file中添加MyConnection.h,从而在class中会出现connection,cursor两个新类

API接口函数类设计：CONNECTION类

classconnection{

friendclasscursor;public:

BOOLIsConnected();

connection();

~connection();

BOOLconnect(char*username,char*password,char*sername);BOOLdisconnect();voiddisplay_error()const;private:Lda_Deflda;

ub1hda[HDA_SIZE];

enumconn_state

{

not_connected,connected};

conn_statestate;};

BOOLconnect(char*username,char*password,char*sername);函数用途：connect函数建立OCI程序与ORACLE数据库的连接参数说明：char*username,--用户名

char*password,--口令

char*sername—主机字符串（数据库别名）。

返回值：连接成功返回TRUE，不成功返回FALSEBOOLdisconnect();

函数用途：disconnect函数断开与数据库的连接参数说明：

返回值：断开成功返回TRUE，不成功返回FALSEBOOLIsConnected();

函数用途：IsConnected函数判断是否与数据库建立了连接。参数说明：

返回值：有连接存在返回值为TRUE，没有连接返回值为FALSEvoiddisplay_error()const;

函数用途：display_error当各个函数返回值为FALSE时，调用此函数可以显示错误信息。返回值：

CURSOR类

classcursor{public:

BOOLIsOpened();

BOOLExecuteSQL(char*stmt);

cursor();~cursor();

BOOLopen(connection*conn_param);BOOLclose();

BOOLparse(constchar*stmt);/*绑定输入*/

BOOLbind_by_position(intsqlvnum,void*progvar,intprogvarlen,

intdatatype,short*indicator);/*定义输出*/

BOOLdefine_by_position(intposition,void*buf,intbufl,intdatatype);//取得列描述信息

BOOLdescribe(intposition,long*dbsize,int*dbtype,void*cbuf,int*cbufl,long*dsize,int*prec,int*scale,int*nullok);BOOLexecute();BOOLfetch();voiddisplay_error();private:

intget_error_code();

Cda_Defcda;connection*conn;

enumcursor_state

{

not_opened,opened};

cursor_statestate;};

BOOLIsOpened();

函数用途：判断游标是否开启参数说明：

返回值：游标开启返回值为TRUE，游标没有开启返回值为FALSEBOOLExecuteSQL(char*stmt);

函数用途：直接执行不带绑定输入和定义输出的SQL语句，如插入、更新、提交、回滚等。实际上完成解析（PARSE）和执行（EXECUTE）的功能。

参数说明：char*stmt构造的SQL语句

返回值：成功执行返回值为TRUE，执行不成功返回值为FALSEBOOLopen(connection*conn_param);函数用途：开启游标

参数说明：connection*conn_paramconnection对象的地址返回值：开启成功返回值为TRUE，开启不成功返回值为FALSEBOOLclose();函数用途：关闭游标参数说明：

返回值：成