org.mapdb

Class StoreHeap

java.lang.Object

org.mapdb.Store

org.mapdb.StoreHeap

All Implemented Interfaces:

Closeable, AutoCloseable, Engine

public class StoreHeap
extends Store

Store which keeps all instances on heap. It does not use serialization.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StoreHeap.Snapshot

Nested classes/interfaces inherited from class org.mapdb.Store

Store.Cache, Store.LongList, Store.LongLongMap, Store.LongObjectMap<V>, Store.LongObjectObjectMap<V1,V2>, Store.LongQueue, Store.MemoryBarrierLessLock, Store.ReadWriteSingleLock

Nested classes/interfaces inherited from interface org.mapdb.Engine

Engine.CloseOnJVMShutdown, Engine.ReadOnly, Engine.ReadOnlyWrapper

Field Summary

Fields

Modifier and Type	Field and Description
protected Store.LongObjectMap[]	data
protected long[]	freeRecid
protected int	freeRecidTail
protected long	maxRecid
protected Lock	newRecidLock
protected static Object	NULL
protected Store.LongObjectMap[]	rollback
protected List<StoreHeap.Snapshot>	snapshots
protected static Object	TOMBSTONE

Fields inherited from class org.mapdb.Store

caches, checksum, closed, commitLock, compress, deserializeExtra, encrypt, encryptionXTEA, FEAT_COMP_LZF, FEAT_CRC, FEAT_ENC_XTEA, fileLockDisable, fileLockHeartbeat, fileName, HEAD_CHECKSUM, HEAD_FEATURES, LOCKING_STRATEGY_NOLOCK, LOCKING_STRATEGY_READWRITELOCK, LOCKING_STRATEGY_WRITELOCK, lockMask, locks, lockScale, LOG, LZF, metricsDataRead, metricsDataWrite, metricsRecordRead, metricsRecordWrite, NOLOCK, readonly, recycledDataOut, snapshotEnable, structuralLock, volumeFactory

Fields inherited from interface org.mapdb.Engine

CLOSED_ENGINE, RECID_CLASS_CATALOG, RECID_FIRST, RECID_LAST_RESERVED, RECID_NAME_CATALOG, RECID_RECORD_CHECK

Constructor Summary

Constructors

Constructor and Description
StoreHeap(boolean txDisabled, int lockScale, int lockingStrategy, boolean snapshotEnable)

Method Summary

Methods

Modifier and Type	Method and Description
protected long	allocateRecid()
void	backup(OutputStream out, boolean incremental)
void	backupRestore(InputStream[] in)
boolean	canRollback()
void	close() Close store/cache.
void	commit() Makes all changes made since the previous commit/rollback permanent.
void	compact()
<A> boolean	compareAndSwap(long recid, A expectedOldValue, A newValue, Serializer<A> serializer) Updates existing record in atomic (Compare And Swap) manner.
protected <A> void	delete2(long recid, Serializer<A> serializer)
boolean	fileLoad() If underlying storage is memory-mapped-file, this method will try to load and precache all file data into disk cache.
protected <A> A	get2(long recid, Serializer<A> serializer)
long	getCurrSize()
long	getFreeSize()
long	preallocate() Preallocates recid for not yet created record.
<A> long	put(A value, Serializer<A> serializer) Insert new record.
void	rollback() Undoes all changes made in the current transaction.
Engine	snapshot() Returns read-only snapshot of data in Engine.
<A> void	update(long recid, A value, Serializer<A> serializer) Update existing record with new value.
protected void	update2(long recid, DataIO.DataOutputByteArray out)
protected void	updateOld(int pos, long recid, Object old)

Methods inherited from class org.mapdb.Store

assertReadLocked, assertWriteLocked, canSnapshot, checkFeaturesBitmap, clearCache, delete, deserialize, forDB, forEngine, get, getWrappedEngine, init, isClosed, isReadOnly, lockPos, longParityGet, longParitySet, makeFeaturesBitmap, metricsCollect, newDataOut2, serialize

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

data

protected final Store.LongObjectMap[] data

rollback

protected final Store.LongObjectMap[] rollback

TOMBSTONE

protected static final Object TOMBSTONE

NULL

protected static final Object NULL

freeRecid

protected long[] freeRecid

freeRecidTail

protected int freeRecidTail

maxRecid

protected long maxRecid

newRecidLock

protected final Lock newRecidLock

snapshots

protected List<StoreHeap.Snapshot> snapshots

Constructor Detail

StoreHeap

public StoreHeap(boolean txDisabled,
         int lockScale,
         int lockingStrategy,
         boolean snapshotEnable)

Method Detail

get2

protected <A> A get2(long recid,
         Serializer<A> serializer)

Specified by:

get2 in class Store

update

public <A> void update(long recid,
              A value,
              Serializer<A> serializer)

Description copied from interface: Engine

Update existing record with new value.

Recid must be a number returned by 'put' method. Behaviour for invalid recid (random number or already deleted record) is not defined, typically it throws 'EndOfFileException', but it may also corrupt store.

Specified by:

update in interface Engine

Overrides:

update in class Store

Parameters:

recid - (record identifier) under which record was persisted.

value - new record value to be stored

serializer - used to serialize record into binary form

update2

protected void update2(long recid,
           DataIO.DataOutputByteArray out)

Specified by:

update2 in class Store

delete2

protected <A> void delete2(long recid,
               Serializer<A> serializer)

Specified by:

delete2 in class Store

compareAndSwap

public <A> boolean compareAndSwap(long recid,
                         A expectedOldValue,
                         A newValue,
                         Serializer<A> serializer)

Description copied from interface: Engine

Updates existing record in atomic (Compare And Swap) manner. Value is modified only if old value matches expected value. There are three ways to match values, MapDB may use any of them:

1. Equality check oldValue==expectedOldValue when old value is found in instance cache
2. Deserializing oldValue using serializer and checking oldValue.equals(expectedOldValue)
3. Serializing expectedOldValue using serializer and comparing binary array with already serialized oldValue

Recid must be a number returned by 'put' method. Behaviour for invalid recid (random number or already deleted record) is not defined, typically it throws 'EndOfFileException', but it may also corrupt store.

Specified by:

compareAndSwap in interface Engine

Overrides:

compareAndSwap in class Store

Parameters:

recid - (record identifier) under which record was persisted.

expectedOldValue - old value to be compared with existing record

newValue - to be written if values are matching

serializer - used to serialize record into binary form

Returns:

true if values matched and newValue was written

updateOld

protected void updateOld(int pos,
             long recid,
             Object old)

getCurrSize

public long getCurrSize()

Specified by:

getCurrSize in class Store

getFreeSize

public long getFreeSize()

Specified by:

getFreeSize in class Store

fileLoad

public boolean fileLoad()

Description copied from class: Store

If underlying storage is memory-mapped-file, this method will try to load and precache all file data into disk cache. Most likely it will call MappedByteBuffer.load(), but could also read content of entire file etc This method will not pin data into memory, they might be removed at any time.

Specified by:

fileLoad in class Store

Returns:

true if this method did something, false if underlying storage does not support loading, or is already in-memory

backup

public void backup(OutputStream out,
          boolean incremental)

Specified by:

backup in class Store

backupRestore

public void backupRestore(InputStream[] in)

Specified by:

backupRestore in class Store

preallocate

public long preallocate()

Description copied from interface: Engine

Preallocates recid for not yet created record. It does not insert any data into it.

Returns:

new recid

allocateRecid

protected long allocateRecid()

put

public <A> long put(A value,
           Serializer<A> serializer)

Description copied from interface: Engine

Insert new record.

Parameters:

value - records to be added

serializer - used to convert record into/from binary form

Returns:

recid (record identifier) under which record is stored.

close

public void close()

Description copied from interface: Engine

Close store/cache. This method must be called before JVM exits to flush all caches and prevent store corruption. Also it releases resources used by MapDB (disk, memory..).

Engine can no longer be used after this method was called. If Engine is used after closing, it may throw any exception including NullPointerException

There is an configuration option DBMaker.Maker.closeOnJvmShutdown() which uses shutdown hook to automatically close Engine when JVM shutdowns.

commit

public void commit()

Description copied from interface: Engine

Makes all changes made since the previous commit/rollback permanent. In transactional mode (on by default) it means creating journal file and replaying it to storage. In other modes it may flush disk caches or do nothing at all (check your config options)

rollback

public void rollback()
              throws UnsupportedOperationException

Description copied from interface: Engine

Undoes all changes made in the current transaction. If transactions are disabled it throws UnsupportedOperationException.

Throws:

UnsupportedOperationException - if transactions are disabled

canRollback

public boolean canRollback()

Returns:

true if engine supports rollback

snapshot

public Engine snapshot()
                throws UnsupportedOperationException

Description copied from interface: Engine

Returns read-only snapshot of data in Engine.

Throws:

UnsupportedOperationException - if snapshots are not supported/enabled

compact

public void compact()