About Persistent-HashMap

The Persistent-HashMap is basically a persistent version of the Java HashMap class.

Features

  • Implements the Map interface so can be used in the exact same way as a regular HashMap.
  • No space needs preallocated.
  • Disk space is immediately reclaimed on removing an object.
  • No maintenance required to keep the data store clean.
  • Caching option that keeps a copy of the map in memory (using a standard HashMap) to speed up access.

Notes

Because the Map interface does not allow for exceptions being thrown null values are used to indicate an error. As such, the map should not be used to store null values otherwise the behaviour is undefined.

The Persistent-HashMap is thread-safe, but does not perform file locking. This means the same data store should not be accessed from multiple processes at once otherwise the behaviour is undefined.

License

The Persistent-HashMap library is released under the GNU General Public License v3.

Credits

The theory is based on HashStore.