文章目錄
對很多C/C++程序員來說,操作Oracle數據庫是一個技術難點,本文講述採用freecplus開源框架操作Oracle數據庫,freecplus框架是C語言技術網作者二十年的技術積累,功能強大,簡單易用。
一、源代碼說明
freecplus是一個Linux系統下的C/C++開源框架,源代碼請前往C語言技術網(www.freecplus.net)下載。
本文介紹的是freecplus框架中採用connection和sqlstatement類操作Oracle數據庫。
類的聲明文件是freecplus/db/oracle/_ooci.h。
類的定義文件是freecplus/db/oracle/_ooci.cpp。
示例程序位於freecplus/db/oracle目錄中。
編譯規則文件是freecplus/db/oracle/makefile。
二、概述
本文不會介紹Oracle數據庫、SQL語言和C/C++的基礎知識,您應該是一個職業的C/C++程序員,在閱讀本文之前,您已經掌握了Oracle數據庫和SQL語言的基礎知識。
Oracle數據庫功能強大,性能卓越,無與倫比,並提供了數據訪問接口OCI,OCI非常強大,強大到了普通C/C++程序員難以駕馭。
freecplus框架把OCI(Oracle Call Interface)封裝成了connection和sqlstatement類,採用封裝後的類操作Oracle數據庫,代碼簡潔優雅,性能卓越。
接下來我先列出connection和sqlstatement類的聲明,然後通過流程圖和示例程序介紹它位的用法。
三、connection類
Oracle數據庫連接池connection類的聲明(程序員不必關心的私有成員和數據結構未列出):
// Oracle數據庫連接池類。
class connection
{
public:
int m_state; // 與數據庫的連接狀態,0-未連接,1-已連接。
CDA_DEF m_cda; // 數據庫操作的結果或最後一次執行SQL語句的結果。
char m_sql[10241]; // SQL語句的文本,最長不能超過10240字節。
connection(); // 構造函數。
~connection(); // 析構函數。
// 登錄數據庫。
// connstr:數據庫的登錄參數,格式:username/password@tnsname,username-用戶名,password-登錄密
// 碼,tnsname-數據庫的服務名,在$ORACLE_HOME/network/admin/tnsnames.ora文件中配置。
// charset:數據庫的字符集,必須與數據庫保持一致,否則會出現中文亂碼的情況。
// autocommitopt:是否啓用自動提交,0-不啓用,1-啓用,缺省是不啓用。
// 返回值:0-成功,其它失敗,失敗的代碼在m_cda.rc中,失敗的描述在m_cda.message中。
int connecttodb(char *connstr,char *charset,int autocommitopt=0);
// 提交事務。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
int commit();
// 回滾事務。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
int rollback();
// 斷開與數據庫的連接。
// 注意,斷開與數據庫的連接時,全部未提交的事務自動回滾。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
int disconnect();
// 執行SQL語句。
// 如果SQL語句不需要綁定輸入和輸出變量(無綁定變量、非查詢語句),可以直接用此方法執行。
// 參數說明:這是一個可變參數,用法與printf函數相同。
// 返回值:0-成功,其它失敗,失敗的代碼在m_cda.rc中,失敗的描述在m_cda.message中,
// 如果成功的執行了非查詢語句,在m_cda.rpc中保存了本次執行SQL影響記錄的行數。
// 程序員必須檢查execute方法的返回值。
// 在connection類中提供了execute方法,是爲了方便程序員,在該方法中,也是用sqlstatement類來完成功能。
int execute(const char *fmt,...);
};
四、sqlstatement類
Oracle數據庫的SQL語句操作sqlstatement類的聲明(程序員不必關心的私有成員和數據結構未列出,對CLOB和BLOB字段操作的方法也未列出):
// 操作SQL語句類。
class sqlstatement
{
OCI_HANDLE m_handle; // SQL句柄。
connection *m_conn; // 數據庫連接池指針。
int m_sqltype; // SQL語句的類型,0-查詢語句;1-非查詢語句。
int m_autocommitopt; // 自動提交標誌,0-關閉;1-開啓。
void err_report(); // 錯誤報告。
OCILobLocator *m_lob; // 指向LOB字段的指針。
int alloclob(); // 初始化lob指針。
int filetolob(FILE *fp); // 把文件的內容導入到clob和blob字段中。
int lobtofile(FILE *fp); // 從clob和blob字段中導出內容到文件中。
void freelob(); // 釋放lob指針。
public:
int m_state; // 與數據庫連接池的綁定狀態,0-未綁定,1-已綁定。
char m_sql[10241]; // SQL語句的文本,最長不能超過10240字節。
CDA_DEF m_cda; // 執行SQL語句的結果。
sqlstatement(); // 構造函數。
sqlstatement(connection *conn); // 構造函數,同時綁定數據庫連接池。
~sqlstatement();
// 綁定數據庫連接池。
// conn:數據庫連接池connection對象的地址。
// 返回值:0-成功,其它失敗,只要conn參數是有效的,並且數據庫的遊標資源足夠,connect方法不會返回失敗。
// 程序員一般不必關心connect方法的返回值。
// 注意,每個sqlstatement只需要綁定一次,在綁定新的connection前,必須先調用disconnect方法。
int connect(connection *conn);
// 取消與數據庫連接池的綁定。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
int disconnect();
// 準備SQL語句。
// 參數說明:這是一個可變參數,用法與printf函數相同。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
// 注意:如果SQL語句沒有改變,只需要prepare一次就可以了。
int prepare(const char *fmt,...);
// 綁定輸入變量的地址。
// position:字段的順序,從1開始,必須與prepare方法中的SQL的序號一一對應。
// value:輸入變量的地址,如果是字符串,內存大小應該是表對應的字段長度加1。
// len:如果輸入變量的數據類型是字符串,用len指定它的最大長度,建議採用表對應的字段長度。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
// 注意:如果SQL語句沒有改變,只需要bindin一次就可以了。
int bindin(unsigned int position,int *value);
int bindin(unsigned int position,long *value);
int bindin(unsigned int position,unsigned int *value);
int bindin(unsigned int position,unsigned long *value);
int bindin(unsigned int position,float *value);
int bindin(unsigned int position,double *value);
int bindin(unsigned int position,char *value,unsigned int len);
// 綁定輸出變量的地址。
// position:字段的順序,從1開始,與SQL的結果集一一對應。
// value:輸出變量的地址,如果是字符串,內存大小應該是表對應的字段長度加1。
// len:如果輸出變量的數據類型是字符串,用len指定它的最大長度,建議採用表對應的字段長度。
// 返回值:0-成功,其它失敗,程序員一般不必關心返回值。
// 注意:如果SQL語句沒有改變,只需要bindout一次就可以了。
int bindout(unsigned int position,int *value);
int bindout(unsigned int position,long *value);
int bindout(unsigned int position,unsigned int *value);
int bindout(unsigned int position,unsigned long *value);
int bindout(unsigned int position,float *value);
int bindout(unsigned int position,double *value);
int bindout(unsigned int position,char *value,unsigned int len);
// 執行SQL語句。
// 返回值:0-成功,其它失敗,失敗的代碼在m_cda.rc中,失敗的描述在m_cda.message中。
// 如果成功的執行了非查詢語句,在m_cda.rpc中保存了本次執行SQL影響記錄的行數。
// 程序員必須檢查execute方法的返回值。
int execute();
// 執行SQL語句。
// 如果SQL語句不需要綁定輸入和輸出變量(無綁定變量、非查詢語句),可以直接用此方法執行。
// 參數說明:這是一個可變參數,用法與printf函數相同。
// 返回值:0-成功,其它失敗,失敗的代碼在m_cda.rc中,失敗的描述在m_cda.message中,
// 如果成功的執行了非查詢語句,在m_cda.rpc中保存了本次執行SQL影響記錄的行數。
// 程序員必須檢查execute方法的返回值。
int execute(const char *fmt,...);
// 從結果集中獲取一條記錄。
// 如果執行的SQL語句是查詢語句,調用execute方法後,會產生一個結果集(存放在數據庫的緩衝區中)。
// next方法從結果集中獲取一條記錄,把字段的值放入已綁定的輸出變量中。
// 返回值:0-成功,1403-結果集已無記錄,其它-失敗,失敗的代碼在m_cda.rc中,失敗的描述在m_cda.message中。
// 返回失敗的原因主要有兩個:1)與數據庫的連接已斷開;2)綁定輸出變量的內存太小。
// 每執行一次next方法,m_cda.rpc的值加1。
// 程序員必須檢查next方法的返回值。
int next();
};
五、程序流程
freecplus框架把對Oracle數據庫操作的SQL語句分爲兩種:有結果集的SQL語句和無結果集的SQL語句。
如果SQL語句被執行後,有結果集的產生,稱爲有結果集的SQL,即數據查詢語言DQL,以select關鍵字,各種簡單查詢,連接查詢等都屬於DQL。
如果SQL語句被執行後,沒有結果集的產生,稱爲無結果集的SQL,包括數據定義語言DDL(主要是create、drop和alter)和數據操縱語言DML(insert、update和insert)。
也可以這麼說,查詢的SQL語句會產生結果集,其它的SQL語句不會產生結果集。
1、無結果集SQL的程序的流程
這是一個完程的流程,在實際開發中,如果是執行簡單的SQL語句,第6步和第7步可能不需要,如果SQL語句只執行一次,第7步和第8步之間的循環也不需要。
2、有結果集SQL的程序的流程
這是一個完程的流程,在實際開發中,如果是執行簡單的查詢語句,第6步、第7步和第8步可能不需要,如果結果集中最多隻有一條記錄,第10步和第11步之間的循環也不需要。
六、示例程序
1、創建超女信息表
示例(createtable.cpp)
/*
* 程序名:createtable.cpp,此程序演示freecplus框架操作Oracle數據庫(創建表)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
// 準備創建表的SQL語句。
// 超女表girls,超女編號id,超女姓名name,體重weight,報名時間btime,超女說明memo,超女圖片pic。
stmt.prepare("\
create table girls(id number(10),\
name varchar2(30),\
weight number(8,2),\
btime date,\
memo clob,\
pic blob,\
primary key (id))");
// prepare方法不需要判斷返回值。
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
printf("create table girls ok.\n");
}
運行效果
2、向超女表中插入5條記錄
示例(inserttable.cpp)
/*
* 程序名:inserttable.cpp,此程序演示freecplus框架操作Oracle數據庫(向表中插入5條記錄)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
// 定義用於超女信息的結構,與表中的字段對應。
struct st_girls
{
long id; // 超女編號,用long數據類型對應Oracle無小數的number(10)。
char name[11]; // 超女姓名,用char[31]對應Oracle的varchar2(30)。
double weight; // 超女體重,用double數據類型對應Oracle有小數的number(8,2)。
char btime[20]; // 報名時間,用char對應Oracle的date,格式:'yyyy-mm-dd hh24:mi:ssi'。
} stgirls;
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
// 準備插入表的SQL語句。
stmt.prepare("\
insert into girls(id,name,weight,btime) \
values(:1,:2,:3,to_date(:4,'yyyy-mm-dd hh24:mi:ss'))");
// prepare方法不需要判斷返回值。
// 爲SQL語句綁定輸入變量的地址,bindin方法不需要判斷返回值。
stmt.bindin(1,&stgirls.id);
stmt.bindin(2, stgirls.name,10);
stmt.bindin(3,&stgirls.weight);
stmt.bindin(4, stgirls.btime,19);
// 模擬超女數據,向表中插入5條測試信息。
for (int ii=1;ii<=5;ii++)
{
memset(&stgirls,0,sizeof(stgirls)); // 結構體變量初始化。
// 爲結構體變量的成員賦值。
stgirls.id=ii; // 超女編號。
sprintf(stgirls.name,"超女%02d",ii); // 超女姓名。
stgirls.weight=ii*2.11; // 超女體重。
strcpy(stgirls.btime,"2018-03-01 12:25:31"); // 報名時間。
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
printf("成功插入了%ld條記錄。\n",stmt.m_cda.rpc); // stmt.m_cda.rpc是本次執行SQL影響的記錄數。
}
printf("insert table girls ok.\n");
conn.commit(); // 提交數據庫事務。
}
運行效果
3、更新超女表中的記錄
示例(updatetable.cpp)
/*
* 程序名:updatetable.cpp,此程序演示freecplus框架操作Oracle數據庫(修改表中的記錄)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
char strbtime[20]; // 用於存放超女的報名時間。
memset(strbtime,0,sizeof(strbtime));
strcpy(strbtime,"2019-12-20 09:45:30");
// 準備更新數據的SQL語句,不需要判斷返回值。
stmt.prepare("\
update girls set btime=to_date(:1,'yyyy-mm-dd hh24:mi:ss') where id>=2 and id<=4");
// prepare方法不需要判斷返回值。
// 爲SQL語句綁定輸入變量的地址,bindin方法不需要判斷返回值。
stmt.bindin(1,strbtime,19);
// 如果不採用綁定輸入變量的方法,把strbtime的值直接寫在SQL語句中也是可以的,如下:
/*
stmt.prepare("\
update girls set btime=to_date('%s','yyyy-mm-dd hh24:mi:ss') where id>=2 and id<=4",strbtime);
*/
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
// 請注意,stmt.m_cda.rpc變量非常重要,它保存了SQL被執行後影響的記錄數。
printf("本次更新了girls表%ld條記錄。\n",stmt.m_cda.rpc);
// 提交事務
conn.commit();
}
運行效果
4、查詢超女表中的記錄
示例(selecttable.cpp)
/*
* 程序名:selecttable.cpp,此程序演示freecplus框架操作Oracle數據庫(查詢表中的記錄)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
// 定義用於超女信息的結構,與表中的字段對應。
struct st_girls
{
long id; // 超女編號,用long數據類型對應Oracle無小數的number(10)。
char name[31]; // 超女姓名,用char[31]對應Oracle的varchar2(30)。
double weight; // 超女體重,用double數據類型對應Oracle有小數的number(8,2)。
char btime[20]; // 報名時間,用char對應Oracle的date,格式:'yyyy-mm-dd hh24:mi:ss'。
} stgirls;
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
int iminid,imaxid; // 查詢條件最小和最大的id。
// 準備查詢表的SQL語句。
stmt.prepare("\
select id,name,weight,to_char(btime,'yyyy-mm-dd hh24:mi:ss') from girls where id>=:1 and id<=:2");
// prepare方法不需要判斷返回值。
// 爲SQL語句綁定輸入變量的地址,bindin方法不需要判斷返回值。
stmt.bindin(1,&iminid);
stmt.bindin(2,&imaxid);
// 爲SQL語句綁定輸出變量的地址,bindout方法不需要判斷返回值。
stmt.bindout(1,&stgirls.id);
stmt.bindout(2, stgirls.name,30);
stmt.bindout(3,&stgirls.weight);
stmt.bindout(4, stgirls.btime,19);
iminid=2; // 指定待查詢記錄的最小id的值。
imaxid=4; // 指定待查詢記錄的最大id的值。
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
// 本程序執行的是查詢語句,執行stmt.execute()後,將會在數據庫的緩衝區中產生一個結果集。
while (1)
{
memset(&stgirls,0,sizeof(stgirls)); // 先把結構體變量初始化。
// 從結果集中獲取一條記錄,一定要判斷返回值,0-成功,1403-無記錄,其它-失敗。
// 在實際開發中,除了0和1403,其它的情況極少出現。
if (stmt.next() !=0) break;
// 把獲取到的記錄的值打印出來。
printf("id=%ld,name=%s,weight=%.02f,btime=%s\n",stgirls.id,stgirls.name,stgirls.weight,stgirls.btime);
}
// 請注意,stmt.m_cda.rpc變量非常重要,它保存了SQL被執行後影響的記錄數。
printf("本次查詢了girls表%ld條記錄。\n",stmt.m_cda.rpc);
}
運行效果
5、查詢超女表中的記錄數
示例(counttable.cpp)
/*
* 程序名:counttable.cpp,此程序演示freecplus框架操作Oracle數據庫(查詢表中的記錄數)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
int icount=0; // 用於存放查詢結果的記錄數。
// 準備查詢表的SQL語句,把查詢條件直接寫在SQL語句中,沒有采用綁定輸入變量的方法。
stmt.prepare("select count(*) from girls where id>=2 and id<=4");
// prepare方法不需要判斷返回值。
// 爲SQL語句綁定輸出變量的地址,bindout方法不需要判斷返回值。
stmt.bindout(1,&icount);
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
// 本程序執行的是查詢語句,執行stmt.execute()後,將會在數據庫的緩衝區中產生一個結果集。
// 但是,在本程序中,結果集永遠只有一條記錄,調用stmt.next()一次就行,不需要循環。
stmt.next();
printf("girls表中符合條件的記錄數是%d。\n",icount);
}
運行效果
7、刪除超女表中的記錄
示例(deletetable.cpp)
/*
* 程序名:deletetable.cpp,此程序演示freecplus框架操作Oracle數據庫(刪除表中的記錄)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
// 失敗代碼在stmt.m_cda.rc中,失敗描述在stmt.m_cda.message中。
// 如果不需要綁定輸入和輸出變量,用stmt.execute()方法直接執行SQL語句,不需要stmt.prepare()。
if (stmt.execute("delete from girls where id>=2 and id<=4") != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
// 請注意,stmt.m_cda.rpc變量非常重要,它保存了SQL被執行後影響的記錄數。
printf("本次從girls表中刪除了%ld條記錄。\n",stmt.m_cda.rpc);
// 提交事務
conn.commit();
}
運行效果
8、執行PL/SQL過程
示例(execplsql.cpp)
/*
* 程序名:execplsql.cpp,此程序演示freecplus框架操作Oracle數據庫(執行PL/SQL過程)。
* 作者:C語言技術網(www.freecplus.net) 日期:20190525
* 說說我個人的看法,我從不在Oracle數據庫中創建PL/SQL過程,也很少使用觸發器,原因如下:
* 1、在Oracle數據庫中創建PL/SQL過程,程序的調試很麻煩;
* 2、維護工作很麻煩,因爲維護人員要花時間去了解數據庫中的存儲過程;
* 3、採用freecplus框架操作Oracle已經是非常簡單,沒必要去折騰存儲過程;
* 4、PL/SQL過程可移植性不好,如果換成mysql或其它數據庫,比較麻煩。
* 還有,我在C/C++程序中很少用複雜的PL/SQL過程,因爲複雜的PL/SQL調試麻煩。
*/
#include "_ooci.h" // freecplus框架操作Oracle的頭文件。
int main(int argc,char *argv[])
{
connection conn; // 數據庫連接類
// 登錄數據庫,返回值:0-成功,其它-失敗。
// 失敗代碼在conn.m_cda.rc中,失敗描述在conn.m_cda.message中。
if (conn.connecttodb("scott/tiger@snorcl11g_198","Simplified Chinese_China.ZHS16GBK")!=0)
{
printf("connect database failed.\n%s\n",conn.m_cda.message); return -1;
}
sqlstatement stmt(&conn); // 操作SQL語句的對象。
int id=100;
// 準備查詢表的PL/SQL語句,先刪除girls表中的全部記錄,再插入一條記錄。
stmt.prepare("\
BEGIN\
delete from girls;\
insert into girls(id,name,weight,btime)\
values(:1,'超女過程',55.65,to_date('2018-01-02 13:00:55','yyyy-mm-dd hh24:mi:ss'));\
END;");
// 注意,PL/SQL中的每條SQL需要用分號結束,END之後還有一個分號。
// prepare方法不需要判斷返回值。
// 爲PL/SQL語句綁定輸入變量的地址,bindin方法不需要判斷返回值。
stmt.bindin(1,&id);
// 執行SQL語句,一定要判斷返回值,0-成功,其它-失敗。
if (stmt.execute() != 0)
{
printf("stmt.execute() failed.\n%s\n%s\n",stmt.m_sql,stmt.m_cda.message); return -1;
}
printf("exec PL/SQL ok.\n");
// 提交事務。
conn.commit();
}
運行效果
9、CLOB和BLOB字段的操作
sqlstatement類還可以操作CLOB和BLOB字段,在實際開發中,這種需求不多,本文就不演示了,如果您在項目開發中有這方面的需求,可以參考demo程序,示例程序位於freecplus/db/oracle目錄中,如下:
filetoclob.cpp:把文本文件存入數據表的CLOB字段。
clobtofile.cpp:把數據表CLOB字段中的內容導出到文本文件中。
filetoblob.cpp:把文本文件存入數據表的BLOB字段。
blobtofile.cpp:把數據表BLOB字段中的內容導出到文本文件中。
八、應用經驗
freecplus框架的connection和sqlstatement類把OCI的強大功能充分的發揮了出來,且性能卓越。本文提供的示例程序看上去簡單,實則很精妙,希望大家多多思考,慢慢體會。
爲了讓大家完全掌握connection和sqlstatement類的用法,我將錄製freecplus框架的專題視頻,請大家多關注C語言技術網(www.freecplus.net)發佈的內容。
七、版權聲明
C語言技術網原創文章,轉載請說明文章的來源、作者和原文的鏈接。
來源:C語言技術網(www.freecplus.net)
作者:碼農有道