lmdb简介及示例代码

lmdb是一款开源的高效快速的内存映射数据库，C语言编写，基于B+树索引，支持MVCC事务处理。它不是一个需要独立运行的数据库管理进程，只要在需要访问lmdb数据库的代码里引用lmdb库，给出数据库所在目录，就能方便地实现读写lmdb数据库。

源码地址：https://github.com/LMDB/lmdb.git

下面简单介绍lmdb的使用，以下代码在 CentOS 7.2 上测试通过。

编译lmdb，生成 liblmdb.a 静态库：

git clone https://github.com/LMDB/lmdb.git
cd lmdb/libraries/liblmdb
make

以下是lmdb数据库读写示例代码main.c，代码逻辑为初始化一个lmdb数据库testdb, 写入一条key-value数据，再从数据库中读出所有的key-value数据，打印输出。

#include <stdio.h>
#include <string.h>
#include "lmdb.h"

int main(int argc, char* argv[]){
    int rc;
    MDB_env *env;
    MDB_dbi dbi;
    MDB_val key, data;
    MDB_txn *txn;
    MDB_cursor *cursor;
    char strKey[50];
    char strValue[50];
    printf("lmdb version:%s\n",mdb_version(0, 0, 0));
    rc = mdb_env_create(&env);
    if(rc){
        printf("mdb_env_create error,detail:%s\n", mdb_strerror(rc));
        return -1;
    }
    
    //打开数据库，如果目录为空，将在该目录内初始化一个数据库
    rc = mdb_env_open(env, "./testdb", 0, 0644);
    if(rc){
        printf("mdb_env_open error,detail:%s\n", mdb_strerror(rc));
        return -1;
    }

    rc = mdb_txn_begin(env, NULL, 0, &txn);
    if(rc){
        printf("mdb_txn_begin error,detail:%s\n", mdb_strerror(rc));
        return -1;
    }

    rc = mdb_dbi_open(txn, NULL, 0, &dbi);
    if(rc){
        printf("mdb_dbi_open error,detail:%s\n", mdb_strerror(rc));
        return -1;
    }

    sprintf(strKey, "%s", "key");
    sprintf(strValue, "%s", "value");
    key.mv_size = strlen(strKey)*sizeof(char);
    key.mv_data = strKey;
    data.mv_size = strlen(strValue)*sizeof(char);
    data.mv_data = strValue;
    
    //写入key-value数据
    rc = mdb_put(txn, dbi, &key, &data, 0);

    //提交
    rc = mdb_txn_commit(txn);
    if (rc) {
        fprintf(stderr, "mdb_txn_commit: (%d) %s\n", rc, mdb_strerror(rc));
        goto leave;
    }

    rc = mdb_txn_begin(env, NULL, MDB_RDONLY, &txn);
    rc = mdb_cursor_open(txn, dbi, &cursor);
    
    //遍历数据库中所有key-value数据
    while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
        memset(strKey, 0, sizeof(strKey));
        memset(strValue, 0, sizeof(strValue));
        strncpy(strKey, (const char*)key.mv_data, (int)key.mv_size);
        strncpy(strValue, (const char*)data.mv_data, (int)data.mv_size);
        printf("key:%s, value:%s\n",strKey, strValue);
    }

    mdb_cursor_close(cursor);
    mdb_txn_abort(txn);

leave:
    mdb_dbi_close(env, dbi);
    mdb_env_close(env);
    return 0;
}

编译代码：

gcc -lpthread -I /root/git/lmdb/libraries/liblmdb main.c -o main /root/git/lmdb/libraries/liblmdb/liblmdb.a

在main程序所在目录，创建数据库目录testdb, 执行main程序：

mkdir testdb
./main

输出：

lmdb version:LMDB 0.9.70: (December 19, 2015)
key:key, value:value

以上示例代码简单展示了lmdb库的用法，更详细的api使用请参考lmdb官方文档。