C++ 操作 LevelDB

我搭建了个人博客主页, 欢迎访问: blog.joelzho.com

一. 安装 LevelDB

CMake 的版本最低需 >= 3.9

1. 拉取源码

建议下载github-release 下的压缩包, 不建议直接clone代码

git clone --depth=1 https://github.com/google/leveldb.git
cd leveldb

2. 编译 & 安装

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release .. && cmake --build .
make
sudo make install

默认安装的文件和路径:

/usr/local/lib/libleveldb.a

/usr/local/include/leveldb/c.h
/usr/local/include/leveldb/cache.h
/usr/local/include/leveldb/comparator.h
/usr/local/include/leveldb/db.h
/usr/local/include/leveldb/dumpfile.h
/usr/local/include/leveldb/env.h
/usr/local/include/leveldb/export.h
/usr/local/include/leveldb/filter_policy.h
/usr/local/include/leveldb/iterator.h
/usr/local/include/leveldb/options.h
/usr/local/include/leveldb/slice.h
/usr/local/include/leveldb/status.h
/usr/local/include/leveldb/table_builder.h
/usr/local/include/leveldb/table.h
/usr/local/include/leveldb/write_batch.h
/usr/local/lib/cmake/leveldb/leveldbTargets.cmake
/usr/local/lib/cmake/leveldb/leveldbTargets-release.cmake
/usr/local/lib/cmake/leveldb/leveldbConfig.cmake
/usr/local/lib/cmake/leveldb/leveldbConfigVersion.cmake

二. C++ 操作示例

// Author: Joel<zhoulindeyx@gmail.com>
// Date: 2019-04-12 Fri 14:12
// Desc: Test LevelDB: Open, Put, WriteBatch and Get etc.

#include <leveldb/db.h> // leveldb::*
#include <leveldb/write_batch.h> // leveldb::WriteBatch
#include <string> // string
#include <iostream> // cout, cerr
#include <cassert> // assert

int main()
{
    leveldb::DB *ldbptr = nullptr;
    leveldb::Options options;
    options.create_if_missing = true;
    
    const std::string db_path = "/var/tmp/ldb1.ldb";
    const std::string key = "KEY1";
    const std::string value = "HELLO_LEVELDB";

    leveldb::Status status = leveldb::DB::Open(options, db_path, &ldbptr);
    if(!status.ok()) {
        std::cerr << "open level db error:" << status.ToString() << std::endl;
        return 0;
    }
    assert(ldbptr != nullptr);
    std::cout << "open level db successfully !" << std::endl;

    // put insert
    {
        leveldb::WriteOptions putOptions;
        putOptions.sync = true;
        // const leveldb::Slice s_key = leveldb::Slice(key);
        // const leveldb::Slice s_value = leveldb::Slice(key);
        status = ldbptr->Put(putOptions, key, value);
        if (!status.ok()) {
            std::cerr << "put data error:" << status.ToString() << std::endl;
            return 0;
        }
        std::cout << "put data successfully!" << std::endl;
    }

    // test batch write
    {
        leveldb::WriteBatch writeBatch;
        writeBatch.Put("username", "Joel");
        writeBatch.Put("gender", "Male");
        writeBatch.Put("job", "Programmer");

        status = ldbptr->Write(leveldb::WriteOptions(), &writeBatch);
        if (!status.ok()) {
            std::cerr << "batch write data error:" << status.ToString() << std::endl;
            return 0;
        }
        std::cout << "batch write data successfully!" << std::endl;
    }

    // get test
    {
        leveldb::ReadOptions getOptions;
        std::string rdVal;
        // Slice(const std::string& s)
        status = ldbptr->Get(getOptions, key, &rdVal);
        if (!status.ok()) {
            std::cerr << "get data error:" << status.ToString() << std::endl;
            return 0;
        }
        std::cout << "get data successfully:" << rdVal << std::endl;
        assert(value == rdVal);
    }

    // test iterator
    {
        leveldb::Iterator *iterator = ldbptr->NewIterator(leveldb::ReadOptions());
        if(!iterator) {
            std::cerr << "can not new iterator" << std::endl;
            return 0;
        }

        // caller must call one of the Seek methods on the iterator before using it
        iterator->SeekToFirst();
        std::cout << "=========== iterator begin ===========" << std::endl;
        while(iterator->Valid())
        {
            leveldb::Slice sKey = iterator->key();
            leveldb::Slice sVal = iterator->value();
            std::cout << "key:" << sKey.ToString() << "\tvalue:" << sVal.ToString() << std::endl;
            iterator->Next();
        }
        std::cout << "=========== iterator end ===========" << std::endl;

        // caller should delete the iterator when it is no longer needed
        delete(iterator);
    }

    // caller should delete leveldb::DB ptr when it is no longer needed
    delete(ldbptr);

    std::cout << "test completed !" << std::endl;
    return 0;
}

三. 示例源码 CMakeLists.txt

cmake_minimum_required(VERSION 3.13)
project(LevelDBTest)

set(CMAKE_CXX_STANDARD 11)

add_executable(LevelDBTest main.cpp)
target_link_libraries(LevelDBTest leveldb.a)
target_link_libraries(LevelDBTest pthread -lm -ldl)

四. 注意:

要正常编包含LevelDB 的项目需要链接 pthread,
就像我的示例代码的 CMakeLists.txt 最后一行写的那样.

五. 参考资料

LevelDB 官网: http://leveldb.org/
LevelDB 源码: https://github.com/google/leveldb
LevelDB 操作文档: https://github.com/google/leveldb/blob/master/doc/index.md
CMake 官网: https://cmake.org/