Berkeley DB——Records

Berkeley DB——Records

 

本文主要讲述如何操作Berkeley DB的记录——Records的Create、Retrieve、Update和Delete。

Key/Data Pair and Dbt object

Berkeley DB中保存的是key/data对，它们都是Dbt对象：

#include <db_cxx.h>   class Dbt { public:        Dbt(void *data, size_t size);        Dbt();        Dbt(const Dbt &);        Dbt &operator = (const Dbt &);        ~Dbt();          void *get_data() const;        void set_data(void *);          u_int32_t get_size() const;        void set_size(u_int32_t);          u_int32_t get_ulen() const;        void set_ulen(u_int32_t);          u_int32_t get_dlen() const;        void set_dlen(u_int32_t);          u_int32_t get_doff() const;        void set_doff(u_int32_t);          u_int32_t get_flags() const;        void set_flags(u_int32_t);          DBT *Dbt::get_DBT();        const DBT *Dbt::get_const_DBT() const;        static Dbt *Dbt::get_Dbt(DBT *dbt);        static const Dbt *Dbt::get_const_Dbt(const DBT *dbt); };

它是DBT对象的c++封装，而DBT是一个结构体。如果我们设置DB的访问方法为B树或者Hash的话，Key可以为任何值。而如果我们定义一个有n-1（相对于有n个字段的关系数据库表）个字段的struct，将类型为这个struct的对象存入数据库的话，就相当于我们存入了n个字段的值了，只是我们不能以data中的字段作为查询条件，而只能以key为查询条件。

Writing Records to the DB

通常情况下，我们需要设置Dbt对象的data和len，以指明需要保存的数据和数据所占用空间的大小——不是指针的大小而是实际数据所占空间的大小。当写数据到DB中的时候，我们需要设置key/data对的size和data。存入的数据最好是那些c/c++的基本数据类型——比如我们想存入字符串，那应该使用char*或者wchar_t*类型，而不是string或者wstring。根据我的实践，如果存入string和wstring会发生一些奇怪的问题，具体看这里。

如果数据库不允许重复记录的话（默认情况，如果想存入重复记录需要对Db设置相应的flag），put方法就相当于关系数据库中的insert or update：

int Db::put(DbTxn *txnid, Dbt *key, Dbt *data, u_int32_t flags);

我们可以给put方法传入不同的flag来控制put的具体行为，这些flag有：

Flag（Db.put）	Description
0	添加数据到数据库中。如果DB不允许重复记录，当已经有相同的key的记录时，将修改原记录，否则存入新记录；如果DB允许重复，则添加新记录。
DB_APPEND	只针对Queue和Recno的DB，将记录添加到数据库的末尾
DB_NODUPDATA	只针对B树和Hash的DB，且数据库需要设置为允许重复记录，如果不存在相同key的记录，则存入新记录，否则返回DB_KEYEXIST
DB_NOOVERWRITE	当不存在key相同的记录时，存入新的记录，而不管DB是否允许有重复记录；否则返回DB_KEYEXIST

 

代码示例：

#include <db_cxx.h> #include <string.h>   ...   char *description = "Grocery bill."; float money = 122.45;   Db my_database(NULL, 0); // Database open omitted for clarity   Dbt key(&money, sizeof(float)); Dbt data(description, strlen(description) + 1);   int ret = my_database.put(NULL, &key, &data, DB_NOOVERWRITE); if (ret == DB_KEYEXIST) {     my_database.err(ret, "Put failed because key %f already exists", money); }

 

Getting Records from the DB

可以使用get方法从DB中根据key来获取数据：

int Db::get(DbTxn *txnid, Dbt *key, Dbt *data, u_int32_t flags);

必须先设定key的值和size，把data当作out参数传入，如果搜索到记录，则数据会写入data参数中，并且get方法返回0，否则返回非零值，这些返回值的含义如下：

Result	Description
0	成功
-30989	没有找到此key的记录

 

get方法也有一个flag参数，常用的flag有：

Flag	Description
0	取出key匹配的一条记录，填充data参数
DB_GET_BOTH	当key和data都匹配时，填充data参数
DB_SET_RECNO	根据行号来搜索记录，key和data参数都将被填充（仅针对B+树的DB）。
DB_MULTIPLE	当key匹配时，返回一批数据到data参数所指的buffer中（针对设置了允许重复记录的DB）

 

一个例子：

#include <db_cxx.h> #include <string.h> ...   float money; char *description;   Db my_database(NULL, 0); // Database open omitted for clarity   money = 122.45;   Dbt key, data; // Use our own memory to retrieve the float. // For data alignment purposes. key.set_data(&money); key.set_ulen(sizeof(float)); key.set_flags(DB_DBT_USERMEM);   my_database.get(NULL, &key, &data, 0);   // Money is set into the memory that we supplied. description = (char *)data.get_data();

 

Deleting Records

删除记录使用del方法：

int Db::del(DbTxn *txnid, Dbt *key, u_int32_t flags);

如果DB设置为允许重复记录的话，那key匹配的所有记录都被删除。想一条条记录删除的话，需要使用游标。

一个例子：

#include <db_cxx.h>   ...   Db my_database(NULL, 0); // Database open omitted for clarity   float money = 122.45; Dbt key(&money, sizeof(float));   my_database.del(NULL, &key, 0);

del方法并不是真正的物理删除，db文件的大小也不会变小——这有点象Access。

An Example

#include "stdafx.h" #include <iostream> #include <db_cxx.h> #include <string.h>       using namespace std; int _tmain(int argc, _TCHAR* argv[]) {        Db db(NULL,0);               u_int32_t oFlags = DB_CREATE; // Open flags;        try        {               db.open(NULL,                // Transaction pointer                      "my_db.db",          // Database file name             NULL,                // Optional logical database name             DB_BTREE,            // Database access method             oFlags,              // Open flags             0);                  // File mode (using defaults)               db.truncate(NULL,0,0);               float money = 122.45;               char *description = "Grocery bill.";                 Dbt key(&money, sizeof(float));               Dbt data(description, strlen(description)+1);               int ret = db.put(NULL, &key, &data, DB_NOOVERWRITE);               cout<<"put data--"<<description<<endl;                 ret = db.get(NULL, &key, &data, DB_GET_BOTH);               cout<<"get key--"<<*((float*)key.get_data())<<endl;               cout<<"get data--"<<(char *)data.get_data()<<endl;                 money = 111;               description = "James--------------------";                data.set_data(description);               data.set_size(strlen(description)+1);               db.put(NULL,&key,&data,DB_NOOVERWRITE);               ret = db.get(NULL, &key, &data, DB_GET_BOTH);               cout<<"get key--"<<*((float*)key.get_data())<<endl;               cout<<"get data--"<<(char *)data.get_data()<<endl;                 money = 191;               description = "Mike";                 data.set_data(description);               data.set_size(strlen(description)+1);               db.put(NULL,&key,&data,DB_NOOVERWRITE);               ret = db.get(NULL, &key, &data, DB_GET_BOTH);               cout<<"get key--"<<*((float*)key.get_data())<<endl;               cout<<"get data--"<<(char *)data.get_data()<<endl;            }        catch(DbException &e)        {               cerr<<"DBException:"<<e.what();        }        catch(std::exception &e)        {               cerr<<"DBException:"<<e.what();        }        system("pause");        return 0; }

 
所有Berkeley DB相关的随笔