levelDB使用与在cygwin编译（一）

LevelDB是google开源的一个key-value存储引擎库，类似于开源的Lucene索引库一样。其他的软件开发者可以利用该库做二次开发，来满足定制需求。LevelDB采用日志式的写方式来提高写性能，但是牺牲了部分读性能。为了弥补牺牲了的读性能，一些人提议使用SSD作为存储介质。

对于本地化的Key-value存储引擎来说，简单的使用一般都分成三个基本的步骤：（1）打开一个数据库实例；（2）对这个数据库实例进行插入，修改和查询操作；（3)最后在使用完成之后，关闭该数据库。下面将详细讨论该三个步骤：

一、打开一个数据库实例

一个leveldb数据库有一个对应一个文件系统目录的名字。该数据库的所有内容都存储在这个目录下。下面的代码描述了怎样打开一个数据库或者建立一个新的数据库。

 

Cpp代码  

1. #include <assert.h>  
2. #include "leveldb/db.h"  
3.   
4. leveldb::DB* db;  
5. leveldb::Options options;  
6. options.create_if_missing = true;  
7. leveldb::Status status = leveldb::DB::Open(options,"/tmp/testdb", &db);  
8. assert(status.ok());  
9.   
10. 如果打开已存在数据库的时候，需要抛出错误。将以下代码插在leveldb::DB::Open方法前面：  
11. options.error_if_exists = true;  

#include <assert.h>
#include "leveldb/db.h"

leveldb::DB* db;
leveldb::Options options;
options.create_if_missing = true;
leveldb::Status status = leveldb::DB::Open(options,"/tmp/testdb", &db);
assert(status.ok());

如果打开已存在数据库的时候，需要抛出错误。将以下代码插在leveldb::DB::Open方法前面：
options.error_if_exists = true;

二、对数据库的简单读、写操作

LevelDB提供了Put，Delete和Get三个方法对数据库进行修改和查询。例如，下面的代码片段描述了怎样将key1对应的value值，移到key2对应的值。

 

C代码  

1. std::string value;  
2. leveldb::Status s = db->Get(leveldb::ReadOptions(), key1, &value);  
3. if(s.ok()) s = db->Put(leveldb::WriteOptions(), key2, value);  
4. if(s.ok()) s = db->Delete(leveldb::WriteOptions(), key1);  

std::string value;
leveldb::Status s = db->Get(leveldb::ReadOptions(), key1, &value);
if(s.ok()) s = db->Put(leveldb::WriteOptions(), key2, value);
if(s.ok()) s = db->Delete(leveldb::WriteOptions(), key1);

三、关闭数据库

在对数据库进行了一系列的操作之后，需要对数据库进行关闭。该操作比较简单：

 

C代码  

1. ... open the db as described above...  
2. ... do something with db ...  
3. delete db;  

... open the db as described above...
... do something with db ...
delete db;

 

上面对levelDB的简单使用做了基本的介绍，接下来就是如何自己写一个完成并且能运行的例子。

1、下载源码 git clone https://code.google.com/p/leveldb/

2、编译源码 cd leveldb && make all

3、编写test.cpp

C代码  

1. #include <assert.h>  
2. #include <string.h>  
3. #include <leveldb/db.h>  
4. #include <iostream>  
5.   
6. int main(){  
7.     leveldb::DB* db;  
8.     leveldb::Options options;  
9.     options.create_if_missing = true;  
10.     leveldb::Status status = leveldb::DB::Open(options,"/tmp/testdb", &db);  
11.     assert(status.ok());  
12.   
13.     //write key1,value1  
14.     std::string key="key";  
15.     std::string value = "value";  
16.   
17.     status = db->Put(leveldb::WriteOptions(), key,value);  
18.     assert(status.ok());  
19.   
20.     status = db->Get(leveldb::ReadOptions(), key, &value);  
21.     assert(status.ok());  
22.     std::cout<<value<<std::endl;  
23.     std::string key2 = "key2";  
24.       
25.     //move the value under key to key2  
26.       
27.     status = db->Put(leveldb::WriteOptions(),key2,value);  
28.     assert(status.ok());  
29.     status = db->Delete(leveldb::WriteOptions(), key);  
30.   
31.     assert(status.ok());  
32.       
33.     status = db->Get(leveldb::ReadOptions(),key2, &value);  
34.       
35.     assert(status.ok());  
36.     std::cout<<key2<<"==="<<value<<std::endl;  
37.       
38.     status = db->Get(leveldb::ReadOptions(),key, &value);  
39.       
40.     if(!status.ok()) std::cerr<<key<<"  "<<status.ToString()<<std::endl;  
41.     else std::cout<<key<<"==="<<value<<std::endl;  
42.       
43.     delete db;  
44.     return 0;  
45. }  

#include <assert.h>
#include <string.h>
#include <leveldb/db.h>
#include <iostream>

int main(){
	leveldb::DB* db;
	leveldb::Options options;
	options.create_if_missing = true;
	leveldb::Status status = leveldb::DB::Open(options,"/tmp/testdb", &db);
	assert(status.ok());

	//write key1,value1
	std::string key="key";
	std::string value = "value";

	status = db->Put(leveldb::WriteOptions(), key,value);
	assert(status.ok());

	status = db->Get(leveldb::ReadOptions(), key, &value);
	assert(status.ok());
	std::cout<<value<<std::endl;
	std::string key2 = "key2";
    
	//move the value under key to key2
	
	status = db->Put(leveldb::WriteOptions(),key2,value);
	assert(status.ok());
	status = db->Delete(leveldb::WriteOptions(), key);

	assert(status.ok());
	
	status = db->Get(leveldb::ReadOptions(),key2, &value);
	
	assert(status.ok());
	std::cout<<key2<<"==="<<value<<std::endl;
	
	status = db->Get(leveldb::ReadOptions(),key, &value);
	
	if(!status.ok()) std::cerr<<key<<"  "<<status.ToString()<<std::endl;
	else std::cout<<key<<"==="<<value<<std::endl;
	
	delete db;
	return 0;
}

 

4、编译链接 g++ -o test test.cpp ../leveldb/libleveldb.a -lpthread -I../leveldb/include

     注意libleveldb.a 和leveldb include的路径。

 

5、运行结果./test：

C代码  

1. value  
2. key2===value  
3. key  NotFound:  

 

提示：levelDB在cygwin下编译

levelDB 本身不支持 Windows 平台, 在 Cygwin 里编译的话, 也会报”Unknow platform”错误. 只需要做一下简单修改, 就能在 Windows 下编译和 levelDB. 首先, 要安装 gcc-4, 而不是 gcc-3.

修改 build_detect_platform, 增加 CYGWIN_* 内容:

case "$TARGET_OS" in
    CYGWIN_*)
        PLATFORM=OS_LINUX
        COMMON_FLAGS="$MEMCMP_FLAG -lpthread -DOS_LINUX -DCYGWIN"
        PLATFORM_LDFLAGS="-lpthread"
        PORT_FILE=port/port_posix.cc
        ;;

修改 port/port_posix.h, 增加” || defined(CYGWIN)”内容:

#if defined(OS_MACOSX) || defined(OS_SOLARIS) || defined(OS_FREEBSD) ||\
    defined(OS_NETBSD) || defined(OS_OPENBSD) || defined(OS_DRAGONFLYBSD) ||\
    defined(OS_ANDROID) || defined(OS_HPUX) || defined(CYGWIN)
// Use fread/fwrite/fflush on platforms without _unlocked variants
#define fread_unlocked fread
#define fwrite_unlocked fwrite
#define fflush_unlocked fflush
#endif