简介
MapDB是一个开放源代码(Apache 2.0授权),嵌入式Java数据库引擎和收集框架。它提供带有范围查询、时效限制、压缩、超栈存储和流功能的map、set、list、queue、Bitmap。MapDB可能是当前最快的Java数据库,性能可与java.util 集合相当。它还提供高级功能,如ACID事务,快照,增量备份等等。
本手册是一项正在进行的工作,它将与MapDB 3.0版本一起完成。我们希望你会发现它很有用。如果您想为MapDB做出贡献,我们将非常乐意接受拉动请求
本手册中的代码示例在github仓库中
快速简介
MapDB是灵活的,具有许多配置选项。但是在大多数情况下,它只配置了几行代码。
获取MapDB
MapDB二进制文件托管在Maven Central存储库中。这里是MapDB的依赖部分。
org.mapdb
mapdb
VERSION
VERSION 是Maven Central 的最后一个版本号。3.0.4
每日版本都在快照库中。最新快照的版本号在这里。
sonatype-snapshots
https://oss.sonatype.org/content/repositories/snapshots
org.mapdb
mapdb
VERSION
您也可以直接从 Maven Central 下载MapDB jar文件。在这种情况下,请注意,MapDB依赖于Eclipse Collections,Guava,Kotlin库和其他一些库。以下是每个版本的依赖关系的完整列表。
Hello World!
以下是一个简单的例子。它打开内存中的HashMap,它使用堆栈存储,它不受垃圾收集的限制:
//import org.mapdb.*
DB db = DBMaker.memoryDB().make();
ConcurrentMap map = db.hashMap("map").createOrOpen();
map.put("something", "here");
HashMap(和其他集合)也可以存储在文件中。在这种情况下,可以在JVM重新启动之间保留内容。有必要调用DB.close()来保护文件免受数据损坏。其他选项是使用写入日志来启用事务。
DB db = DBMaker.fileDB("file.db").make();
ConcurrentMap map = db.hashMap("map").createOrOpen();
map.put("something", "here");
db.close();
Hello World示例没有覆盖提交。
默认情况下,MapDB使用泛型序列化,可以序列化任何数据类型。使用专门的串行器,速度更快,记忆效率更高。此外,我们还可以在64位操作系统上启用更快速的内存映射文件:
DB db = DBMaker.fileDB("file.db").fileMmapEnable().make();
ConcurrentMap map =
db.hashMap("map", Serializer.STRING, Serializer.LONG)
.createOrOpen();
map.put("something", 111L);
db.close();
快速提示
内存映射文件要快得多,应该在64位系统上启用,以获得更好的性能。
MapDB具有快速批量导入集合的机制。它比Map.put()快得多。事务具有性能开销,但没有它们,如果没有正确关闭,则存储将被损坏。
存储在MapDB中的数据(键和值)应该是不可变的。MapDB在后台序列化对象。
MapDB有时需要压缩。运行DB.compact()或查看背景压缩选项。
DB和DBMaker
MapDB可以像Lego一样插拔。有两个类就像不同部分的插接块一样,即DBMaker和DB类。
DBMaker类处理数据库配置、创建和打开。MapDB有几种模式和配置选项,都可以使用这个类设置。
一个数据库实例代表了一个打开的数据库(或单个事务会话)。它可用于创建和打开集合存储。它还可以使用commit(),rollback()和close()等方法来处理数据库的生命周期。
要打开(或创建)一个存储,可以使用许多*DB 静态方法,例如DBMaker.fileDB()。MapDB具有很多格式和模式,每个xxxDB()使用不同的模式:memoryDB()打开一个由byte [] 数组支持的内存数据库,
appendFileDB()打开一个使追加的日志文件等。
一个xxxDB()方法后可跟一个或多个配置项,最后一个应用所有选项的make()方法打开选定的存储并返回一个DB 对象。此示例打开启用加密的文件存储:
DB db = DBMaker.fileDB("/some/file")
//TODO encryption API
//.encryptionEnable("password")
.make();
打开并创建集合
一旦你创建了DB,你可以打开一个集合或其他记录。DB使用构建器样式配置。它可以选择集合类型(hashMap ,treeSet …)并命名,然后进行配置,最终可以直接进行操作。
下边的例子打开(或创建新的)TreeSet命名为“example”
NavigableSet treeSet = db.treeSet("example").createOrOpen();
还可以应用其他配置:
NavigableSet treeSet =
db.treeSet("treeSet").maxNodeSize(112).
createOrOpen();
构建器可以以三种不同的方法结束:
create() 创建新的集合。 如果集合存在,将扔出异常。
open() 打开存在的集合。 如果集合不存在,将扔出异常。
createOrOpen() 如果存在就打开, 否则创建。
DB不限于集合, 还可以创建其他类型的记录,如原子记录:
Atomic.Var var = db.atomicVar("mainPerson",Person.SERIALIZER).createOrOpen();
事务
DB具有处理事务生命周期的方法: commit() , rollback() and close() .
一个DB 对象表示单个事务。上面的例子每个存储使用单个全局事务,这对于一些应用是足够的:
ConcurrentNavigableMap map =
db.treeMap("collectionName", Serializer.INTEGER, Serializer.STRING).
createOrOpen();
map.put(1,"one");
map.put(2,"two");
//map.keySet() is now [1,2] even before commit
db.commit(); //persist changes into disk map.put(3,"three");
//map.keySet() is now [1,2,3] db.rollback(); //revert recent changes
//map.keySet() is now [1,2]
db.close();