https://github.com/jankotek/mapdb

MapDB provides concurrent Maps, Sets and Queues backed by disk storage or off-heap-memory. It is a fast and easy to use embedded Java database engine.
https://github.com/jankotek/mapdb

Last synced: about 16 hours ago
JSON representation

MapDB provides concurrent Maps, Sets and Queues backed by disk storage or off-heap-memory. It is a fast and easy to use embedded Java database engine.

• Host: GitHub
• URL: https://github.com/jankotek/mapdb
• Owner: jankotek
• License: apache-2.0
• Created: 2012-08-17T15:28:54.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-06-04T19:19:49.000Z (4 months ago)
• Last Synced: 2024-09-21T22:04:55.416Z (4 days ago)
• Language: Java
• Homepage: https://mapdb.org
• Size: 9.77 MB
• Stars: 4,886
• Watchers: 312
• Forks: 873
• Open Issues: 190
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


MapDB: database engine 

=======================

[![Build Status](https://travis-ci.org/jankotek/mapdb.svg?branch=master)](https://travis-ci.org/jankotek/mapdb)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.mapdb/mapdb/badge.svg)](https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.mapdb%22%20AND%20a%3Amapdb)

[![Join the chat at https://gitter.im/jankotek/mapdb](https://badges.gitter.im/jankotek/mapdb.svg)](https://gitter.im/jankotek/mapdb?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

MapDB combines embedded database engine and Java collections.

It is free under Apache 2 license. MapDB is flexible and can be used in many roles:

* Drop-in replacement for Maps, Lists, Queues and other collections.

* Off-heap collections not affected by Garbage Collector

* Multilevel cache with expiration and disk overflow.

* RDBMs replacement with  transactions, MVCC, incremental backups etc…

* Local data processing and filtering. MapDB has utilities to process huge quantities of data in reasonable time.

Hello world

-------------------

Maven snippet, VERSION is [![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.mapdb/mapdb/badge.svg)](https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.mapdb%22%20AND%20a%3Amapdb)

```xml

    org.mapdb

    mapdb

    VERSION

```

Hello world:

```java

//import org.mapdb.*

DB db = DBMaker.memoryDB().make();

ConcurrentMap map = db.hashMap("map").make();

map.put("something", "here");

```

You can continue with [quick start](https://jankotek.gitbooks.io/mapdb/content/quick-start/) or refer to the  [documentation](https://jankotek.gitbooks.io/mapdb/).

Support

------------

More [details](http://www.mapdb.org/support/).

Development

--------------------

MapDB is written in Kotlin, you will need IntelliJ Idea.

You can use Gradle to build MapDB.

MapDB is extensively unit-tested.

By default, only tiny fraction of all tests are executed, so build finishes under 10 minutes.

Full test suite has over million test cases and runs for several hours/days.

To run full test suite, set `-Dmdbtest=1` VM option.

Longer unit tests might require more memory. Use this to increase heap memory assigned to unit tests: `-DtestArgLine="-Xmx3G"`

By default unit tests are executed in 3 threads. Thread count is controlled by `-DtestThreadCount=3` property

On machine with limited memory you can change fork mode so unit test consume less RAM, but run longer: `-DtestReuseForks=false`