LevelDB JNI技术文档

1. 安装指南

Maven依赖

您可以通过添加以下依赖项到您的Maven POM文件中来使用LevelDB JNI：

<dependencies>
  <dependency>
    <groupId>org.fusesource.leveldbjni</groupId>
    <artifactId>leveldbjni-all</artifactId>
    <version>1.8</version>
  </dependency>
</dependencies>

使用leveldbjni-all依赖项可以让您获得所有支持平台的操作系统特定本地驱动程序。如果您只想使用一个或一些而非所有本地驱动程序，请直接使用操作系统特定的依赖项，而不是leveldbjni-all。

例如，对于Linux 64位系统，请使用以下依赖项：

<dependencies>
  <dependency>
    <groupId>org.fusesource.leveldbjni</groupId>
    <artifactId>leveldbjni-linux64</artifactId>
    <version>1.8</version>
  </dependency>
</dependencies>

如果您的系统已经通过包管理器（请参阅issue 90）单独安装了leveljni本地驱动程序DLL/SO库，那么您可以依赖Java“启动器”，而不包含操作系统的特定本地驱动程序的JAR，如下所示：

<dependency>
  <groupId>org.fusesource.leveldbjni</groupId>
  <artifactId>leveldbjni</artifactId>
  <version>1.8</version>
</dependency>

手动安装JAR

如果不想使用Maven，可以直接将以下JAR添加到您的Java项目中：

leveldbjni-all-1.8.jar

2. 使用说明

LevelDB JNI提供了对LevelDB C++库的Java接口，LevelDB是一个由Google开发的快速键值存储库，提供了字符串键到字符串值的有序映射。

API 使用文档

以下是一些推荐的包导入：

import org.iq80.leveldb.*;
import static org.fusesource.leveldbjni.JniDBFactory.*;
import java.io.*;

打开和关闭数据库

Options options = new Options();
options.createIfMissing(true);
DB db = factory.open(new File("example"), options);
try {
  // 在此处使用数据库...
} finally {
  // 确保关闭数据库，以关闭数据库并避免资源泄漏。
  db.close();
}

添加、获取和删除键/值

db.put(bytes("Tampa"), bytes("rocks"));
String value = asString(db.get(bytes("Tampa")));
db.delete(bytes("Tampa"));

执行批量/大量/原子更新

WriteBatch batch = db.createWriteBatch();
try {
  batch.delete(bytes("Denver"));
  batch.put(bytes("Tampa"), bytes("green"));
  batch.put(bytes("London"), bytes("red"));

  db.write(batch);
} finally {
  // 确保关闭batch，以避免资源泄漏。
  batch.close();
}

遍历键/值

DBIterator iterator = db.iterator();
try {
  for(iterator.seekToFirst(); iterator.hasNext(); iterator.next()) {
    String key = asString(iterator.peekNext().getKey());
    String value = asString(iterator.peekNext().getValue());
    System.out.println(key + " = " + value);
  }
} finally {
  // 确保关闭iterator，以避免资源泄漏。
  iterator.close();
}

使用数据库的快照视图

ReadOptions ro = new ReadOptions();
ro.snapshot(db.getSnapshot());
try {
  // 所有读取操作现在将使用相同的一致数据视图。
  ... = db.iterator(ro);
  ... = db.get(bytes("Tampa"), ro);
} finally {
  // 确保关闭快照，以避免资源泄漏。
  ro.snapshot().close();
}

使用自定义比较器

DBComparator comparator = new DBComparator(){
    public int compare(byte[] key1, byte[] key2) {
        return new String(key1).compareTo(new String(key2));
    }
    public String name() {
        return "simple";
    }
    public byte[] findShortestSeparator(byte[] start, byte[] limit) {
        return start;
    }
    public byte[] findShortSuccessor(byte[] key) {
        return key;
    }
};
Options options = new Options();
options.comparator(comparator);
DB db = factory.open(new File("example"), options);

禁用压缩

Options options = new Options();
options.compressionType(CompressionType.NONE);
DB db = factory.open(new File("example"), options);

配置缓存

Options options = new Options();
options.cacheSize(100 * 1048576); // 100MB缓存
DB db = factory.open(new File("example"), options);

获取近似大小

long[] sizes = db.getApproximateSizes(new Range(bytes("a"), bytes("k")), new Range(bytes("k"), bytes("z")));
System.out.println("Size: " + sizes[0] + ", " + sizes[1]);

获取数据库状态

String stats = db.getProperty("leveldb.stats");
System.out.println(stats);

获取信息性日志消息

Logger logger = new Logger() {
  public void log(String message) {
    System.out.println(message);
  }
};
Options options = new Options();
options.logger(logger);
DB db = factory.open(new File("example"), options);

销毁数据库

Options options = new Options();
factory.destroy(new File("example"), options);

修复数据库

Options options = new Options();
factory.repair(new File("example"), options);

使用内存池

JniDBFactory.pushMemoryPool(1024 * 512);
try {
  // ... 在此处使用数据库
} finally {
  JniDBFactory.popMemoryPool();
}

3. 项目安装方式

请参照“安装指南”中的步骤进行安装。

结束

本文档详细介绍了LevelDB JNI的安装方法、使用说明和API使用方式，希望能帮助您更好地使用LevelDB JNI项目。