FireBird是一种小巧的关系型数据库,它有多种版本,包括服务器版(象MySQL),单机版(象Access)以及嵌入式(象SQLite)。而且不管是服务器版还是嵌入式版它都完整支持视图、触发器、存储过程等SQL高级特性。
问题是它提供的C API“不太友好”,不容易掌握(特别是我),所以我一直只会在C++Builder里编程使用FireBird(因为FireBird源于 Borland的InterBase,VCL库自带了InterBase的组件),直到有一天我发现了IBPP...
IBPP是一个 FireBird/Interbase数据库API的C++包装,使用起来也比较简单,只要把IBPP源码目录里的 "core/all_in_one.cpp"加入工程,在代码中包含头文件"ibpp.h",最后根据操作系统预定义一个IBPP_WINDOWS或 IBPP_UNIX的宏即可。
另外,当然还要安装FireBird客户端,如果只是学习,我们可以下载嵌入式版本。IBPP首先要找到FireBird的动态库,在Windows下, IBPP在下面的路径中查找:
- 在程序目录下查找fbembed.dll
- 在程序目录下查找fbclient.dll
- 依据DefaultInstance注册表键值查找fbclient.dll
- 在系统定义位置查找fbclient.dll
- 在系统定义位置查找gds32.dll
FireBird主页:http://www.ibphoenix.com
IBPP主页:http://www.ibpp.org
关于FireBird的中文教程我推荐姚启红编著的《Borland InterBase7.0 应用开发指南》(网上一找一大堆)。
例一,基本应用
- #include <iostream>
- #include <ibpp.h>
- using namespace std;
-
- const char* g_szDBName = "d:\\test.fdb";
- const char* g_szServerName = "";
-
- const char* g_szUserName = "SYSDBA";
- const char* g_szPassword = "masterkey";
-
- int main()
- {
- IBPP::Database db = IBPP::DatabaseFactory(g_szServerName,
- g_szDBName,
- g_szUserName,
- g_szPassword);
-
- db->Create(3);
-
- db->Connect();
-
- IBPP::Transaction tr = IBPP::TransactionFactory(db);
- tr->Start();
- try{
- IBPP::Statement st = IBPP::StatementFactory(db,tr);
-
- st->Execute(
- "CREATE TABLE TESTTABLE("
- " ID INTEGER NOT NULL PRIMARY KEY,"
- " RNO VARCHAR(10) NOT NULL UNIQUE,"
- " SHIFT VARCHAR(5) NOT NULL"
- " CHECK(SHIFT IN('A','B','C','D')),"
- " LINE CHAR(20) NOT NULL,"
- " SL COMPUTED BY(SHIFT||'.'||LINE),"
- " EMP CHAR(20)"
- " )"
- );
- tr->CommitRetain();
-
- st->Execute(
- "INSERT INTO TESTTABLE(ID,RNO,SHIFT,LINE,EMP)"
- "VALUES(1,'B9527','B','DAZHA','Hua,An')"
- );
- st->Execute(
- "INSERT INTO TESTTABLE(ID,RNO,SHIFT,LINE,EMP)"
- "VALUES(2,'B9528','B','ZHUANGSI','Xiao,Qiang')"
- );
-
- tr->CommitRetain();
-
- st->Execute(
- "INSERT INTO TESTTABLE(ID,RNO,SHIFT,LINE,EMP)"
- "VALUES(3,'B9525','A','DAZHA','Shi,Liu')"
- );
-
- st->Execute(
- "INSERT INTO TESTTABLE(ID,RNO,SHIFT,LINE,EMP)"
- "VALUES(4,'B9526','X','DAZHA','Zhu,ZiShang')"
- );
- tr->Commit();
- }
- catch(IBPP::SQLException &e){
- cerr << e.what() << endl;
- tr->Rollback();
- }
-
- tr->Start();
- try{
- IBPP::Statement st = IBPP::StatementFactory(db,tr);
- st->Execute("SELECT RNO, EMP FROM TESTTABLE");
-
- while(st->Fetch())
- {
- string rno, emp;
- st->Get("RNO",rno);
- st->Get("EMP",emp);
- cout << "RNO:" << rno << " EMP:" << emp << endl;
- }
- tr->Commit();
- }
- catch(IBPP::SQLException &e){
- cerr << e.what() << endl;
- tr->Rollback();
- }
- }
要让程序正确执行,就得保证程序能找到FireBird的动态链接库。对于嵌入式版本来说,下载后把压缩包中的fbembed.dll, firebird.conf,firebird.msg,ib_util.dll以及intl文件夹解压到你的程序目录中就可以运行了。对于服务器版,只要安装客户端并把fbclient.dll放到程序目录里就行(当然权限也要有啦)。
上例中使用IBPP的步骤是:
- 用工厂函数IBPP::DatabaseFactory生成IBPP::Database实例,然后调用它的Connect()成员变量连接数据库。
- 如果要建立数据库的话,使用Database::Create(int dialect)。其中dialect一般取值为3,它的含义如下:
SQL Dialect | 含义 |
---|
1 | 兼容InterBase 5.5及更早版本。 |
2 | 1和3的过渡版本。 |
3 | InterBase 6.0及以后版本,可以使用分隔符,精确数字和时间格式。 |
- 使用工厂函数IBPP::TransactionFactory生成IBPP::Transaction实例,然后用它的Start()开始事务,最后用Commit()来提交事务或Rollback()撤销事务。
- 使用工厂函数IBPP::StatementFactory生成IBPP::Statement实例,然后用它的Execute()来执行SQL命令。
- 值 得注意的是,IBPP中的Database,Transaction,Statement等由工厂函数返回的数据都是智能指针类型,它们能够在退出有效域 时自动执行一些保证完整性的操作。(比如我们使用tr->Start()后即便不调用tr->Commit(),在超出tr变量作用域后系统 也会自动调用Commit的)
- #include <iostream>
- #include <algorithm>
- #include <assert.h>
- #include <ibpp.h>
- using namespace std;
-
- const char* g_szDBName = "d:\\test.fdb";
- const char* g_szServerName = "";
-
- const char* g_szUserName = "SYSDBA";
- const char* g_szPassword = "masterkey";
-
- int main()
- {
- IBPP::Database db;
- db = IBPP::DatabaseFactory(g_szServerName,
- g_szDBName,
- g_szUserName,
- g_szPassword);
-
- db->Connect();
-
- IBPP::Transaction tr = IBPP::TransactionFactory(db);
- tr->Start();
- try{
- IBPP::Statement st = IBPP::StatementFactory(db,tr);
-
- st->ExecuteImmediate(
- "CREATE TABLE BlobTable("
- " ID INTEGER NOT NULL,"
- " RES BLOB)"
- );
-
- st->ExecuteImmediate(
- "CREATE GENERATOR BlobTable_ID_Gen"
- );
-
- st->ExecuteImmediate(
- "CREATE TRIGGER BlobTable_BI_ID FOR BlobTable "
- "ACTIVE BEFORE INSERT POSITION 0 "
- "AS "
- "BEGIN "
- " IF(NEW.ID IS NULL) THEN "
- " NEW.ID = GEN_ID(BlobTable_ID_Gen, 1); "
- "END"
- );
- tr->CommitRetain();
-
- st->Prepare("INSERT INTO BlobTable(RES) VALUES(?)");
- assert(1 == st->Parameters());
-
- {
- IBPP::Blob res = IBPP::BlobFactory(db,tr);
- res->Create();
- char buf[100];
- for(int i=0; i<100; i++) buf[i]=i;
- res->Write(buf,sizeof(buf));
- res->Close();
- st->Set(1,res);
- st->Execute();
- }
-
- {
- st->Set(1,string("HAHAHAHAHAHA..."));
- st->Execute();
- }
- tr->Commit();
- }
- catch(IBPP::SQLException &e){
- cerr << e.what() << endl;
- tr->Rollback();
- }
-
- tr->Start();
- try{
- IBPP::Statement st = IBPP::StatementFactory(db,tr);
- st->Execute("SELECT * FROM BlobTable");
-
- while(st->Fetch())
- {
- int id;
- IBPP::Blob res = IBPP::BlobFactory(db,tr);
-
- st->Get(1,id);
- st->Get(2,res);
-
-
- res->Open();
- int size;
- res->Info(&size,NULL,NULL);
- cout << id << " size is " << size << endl;
- char c;
- while(res->Read(&c,1))
- {
- cout << (int)c << ' ';
- }
- cout << endl;
- }
- tr->Commit();
- }
- catch(IBPP::SQLException &e){
- cerr << e.what() << endl;
- tr->Rollback();
- }
- }
本例连接例一建立的数据库,然后新建一个名为BlobTable的表,里面只有ID和RES字段,而且还为ID字段建立了一个生成器和触发器,这样就可以 让FireBird自动为ID赋值了,具体内容可以看FireBird教程。与例一不同的是这里使用了IBPP::Statement的 ExecuteImmediate()方法,它立即执行其中的SQL语句,而Execute()则有一个先准备、再执行的过程,对于只执行一次的SQL, 可以使用ExecuteImmediate(),如果执行次数较多,则建议使用Execute()。
RES字段是一个Blob型字段,从本例可以看出给Blob字段赋值的方法是:
- 用IBPP::Statement的Prepare()方法准备SQL插入语句,其中的Blob字段使用问号?代替。
- 用工厂函数IBPP::BlobFactory生成一个IBPP::Blob实例,然后分别调用它的Create(),Write()和Close()输入数据,最后用IBPP::Statement的Set()方法写入。
- 所有数据准备就绪后,执行IBPP::Statement的Execute()方法。
如果只想往Blob中存放文本数据,也可以直接用IBPP::Statement的Set()方法写入std::string类型。
从Blob字段取值的方法正好相反:
- 用IBPP::Statement的Execute()方法或ExecuteImmediate()方法执行SELECT语句。
- 使用IBPP::Statement的Fetch()方法提取出当前行的数据。
- 使用IBPP::Statement的Get()方法取出指定列的数据,如果是Blob类型,则使用IBPP::Blob实例作为输入。
- 最后分别调用IBPP::Blob的Open(),Read()和Close()方法取出数据(IBPP::Blob也是一个智能指针类型,所以上例中没有显式地使用Close()关闭)。