Store

java.lang.Object
- org.mapdb.Store

All Implemented Interfaces:

Engine

Direct Known Subclasses:

StoreAppend, StoreDirect, StoreHeap
```
public abstract class Store
extends java.lang.Object
implements Engine
```
Low level record store.

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`checksum`
`protected static int`	`CHECKSUM_FLAG_MASK`
`protected static int`	`CHUNK_SIZE`
`protected static int`	`CHUNK_SIZE_MOD_MASK`
`(package private) java.util.List<java.lang.Runnable>`	`closeListeners`
`protected boolean`	`compress`
`protected static int`	`COMPRESS_FLAG_MASK`
`protected boolean`	`encrypt`
`protected static int`	`ENCRYPT_FLAG_MASK`
`protected EncryptionXTEA`	`encryptionXTEA`
`private static int`	`LOCK_MASK`
`protected java.util.concurrent.locks.ReentrantReadWriteLock[]`	`locks`
`protected static java.util.logging.Logger`	`LOG`
`protected java.lang.ThreadLocal<CompressLZF>`	`LZF`
`protected java.util.concurrent.locks.ReentrantReadWriteLock`	`newRecidLock`
`protected byte[]`	`password`
`protected java.util.Queue<DataOutput2>`	`recycledDataOuts`
`protected SerializerPojo`	`serializerPojo` default serializer used for persistence.
`protected java.util.concurrent.locks.Lock`	`serializerPojoInitLock`
`protected java.util.concurrent.locks.ReentrantLock`	`structuralLock`

Fields inherited from interface org.mapdb.Engine
CATALOG_RECID, CHECK_RECORD, CLASS_INFO_RECID, LAST_RESERVED_RECID

Constructor Summary

Constructors
Modifier Constructor and Description

protected Store(boolean checksum, boolean compress, byte[] password, boolean disableLocks)

Constructors
Modifier	Constructor and Description
`protected`	`Store(boolean checksum, boolean compress, byte[] password, boolean disableLocks)`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract java.lang.String`	`calculateStatistics()` get some statistics about store.
`boolean`	`canSnapshot()`
`void`	`closeListenerRegister(java.lang.Runnable closeListener)`
`void`	`closeListenerUnregister(java.lang.Runnable closeListener)`
`protected <A> A`	`deserialize(Serializer<A> serializer, int size, java.io.DataInput input)`
`protected int`	`expectedMasks()`
`static Store`	`forDB(DB db)` traverses `EngineWrapper`s and returns underlying `Store`
`static Store`	`forEngine(Engine e)` traverses `EngineWrapper`s and returns underlying `Store`
`abstract long`	`getCurrSize()` returns current size occupied by physical store (does not include index).
`abstract java.util.Iterator<java.lang.Long>`	`getFreeRecids()`
`abstract long`	`getFreeSize()` returns free size in physical store (does not include index).
`abstract long`	`getMaxRecid()`
`abstract java.nio.ByteBuffer`	`getRaw(long recid)`
`SerializerPojo`	`getSerializerPojo()` Returns default serializer associated with this engine.
`abstract long`	`getSizeLimit()` returns maximal store size or `0` if there is no limit
`protected void`	`lockAllWrite()`
`protected static int`	`lockPos(long key)`
`protected DataOutput2`	`newDataOut2()`
`void`	`printStatistics()`
`protected <A> DataOutput2`	`serialize(A value, Serializer<A> serializer)`
`Engine`	`snapshot()` Returns read-only snapshot of data in Engine.
`protected void`	`unlockAllWrite()`
`abstract void`	`updateRaw(long recid, java.nio.ByteBuffer data)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.mapdb.Engine
canRollback, clearCache, close, commit, compact, compareAndSwap, delete, get, isClosed, isReadOnly, preallocate, preallocate, put, rollback, update

Field Detail

LOG

protected static final java.util.logging.Logger LOG

checksum
```
protected final boolean checksum
```

compress
```
protected final boolean compress
```

encrypt
```
protected final boolean encrypt
```

password
```
protected final byte[] password
```

encryptionXTEA

protected final EncryptionXTEA encryptionXTEA

CHECKSUM_FLAG_MASK
```
protected static final int CHECKSUM_FLAG_MASK
```
See Also:

Constant Field Values

COMPRESS_FLAG_MASK
```
protected static final int COMPRESS_FLAG_MASK
```
See Also:

Constant Field Values

ENCRYPT_FLAG_MASK
```
protected static final int ENCRYPT_FLAG_MASK
```
See Also:

Constant Field Values

CHUNK_SIZE
```
protected static final int CHUNK_SIZE
```
See Also:

Constant Field Values

CHUNK_SIZE_MOD_MASK
```
protected static final int CHUNK_SIZE_MOD_MASK
```
See Also:

Constant Field Values

serializerPojo
```
protected SerializerPojo serializerPojo
```
default serializer used for persistence. Handles POJO and other stuff which requires write-able access to Engine

LZF

protected final java.lang.ThreadLocal<CompressLZF> LZF

serializerPojoInitLock

protected java.util.concurrent.locks.Lock serializerPojoInitLock

structuralLock

protected final java.util.concurrent.locks.ReentrantLock structuralLock

newRecidLock

protected final java.util.concurrent.locks.ReentrantReadWriteLock newRecidLock

locks

protected final java.util.concurrent.locks.ReentrantReadWriteLock[] locks

recycledDataOuts

protected final java.util.Queue<DataOutput2> recycledDataOuts

LOCK_MASK
```
private static final int LOCK_MASK
```
See Also:

Constant Field Values

closeListeners

java.util.List<java.lang.Runnable> closeListeners

Constructor Detail

Store

protected Store(boolean checksum,
                boolean compress,
                byte[] password,
                boolean disableLocks)

Method Detail
- getMaxRecid
```
public abstract long getMaxRecid()
```
- getRaw
```
public abstract java.nio.ByteBuffer getRaw(long recid)
```
- getFreeRecids
```
public abstract java.util.Iterator<java.lang.Long> getFreeRecids()
```
- updateRaw
```
public abstract void updateRaw(long recid,
                               java.nio.ByteBuffer data)
```
- getSizeLimit
```
public abstract long getSizeLimit()
```
  returns maximal store size or `0` if there is no limit
- getCurrSize
```
public abstract long getCurrSize()
```
  returns current size occupied by physical store (does not include index). It means file allocated by physical file
- getFreeSize
```
public abstract long getFreeSize()
```
  returns free size in physical store (does not include index).
- calculateStatistics
```
public abstract java.lang.String calculateStatistics()
```
  get some statistics about store. This may require traversing entire store, so it can take some time.
- printStatistics
```
public void printStatistics()
```
- getSerializerPojo
```
public SerializerPojo getSerializerPojo()
```
  Description copied from interface: Engine
  
  Returns default serializer associated with this engine. The default serializer will be moved from Engine into DB, so it is deprecated now and this method will be removed.
  
  Specified by:
  
  getSerializerPojo in interface Engine
  
  Returns:
  
  default serializer used in this DB, it handles POJO and other stuff.
- lockAllWrite
```
protected void lockAllWrite()
```
- unlockAllWrite
```
protected void unlockAllWrite()
```
- serialize
```
protected <A> DataOutput2 serialize(A value,
                                    Serializer<A> serializer)
```
- newDataOut2
```
protected DataOutput2 newDataOut2()
```
- deserialize
```
protected <A> A deserialize(Serializer<A> serializer,
                            int size,
                            java.io.DataInput input)
                     throws java.io.IOException
```
  Throws:
  
  java.io.IOException
- forDB
```
public static Store forDB(DB db)
```
  traverses EngineWrappers and returns underlying Store
- forEngine
```
public static Store forEngine(Engine e)
```
  traverses EngineWrappers and returns underlying Store
- expectedMasks
```
protected int expectedMasks()
```
- lockPos
```
protected static int lockPos(long key)
```
- canSnapshot
```
public boolean canSnapshot()
```
  Specified by:
  
  canSnapshot in interface Engine
  
  Returns:
  
  true if engine can create read-only snapshots
- snapshot
```
public Engine snapshot()
                throws java.lang.UnsupportedOperationException
```
  Description copied from interface: Engine
  
  Returns read-only snapshot of data in Engine.
  
  Specified by:
  
  snapshot in interface Engine
  
  Throws:
  
  java.lang.UnsupportedOperationException - if snapshots are not supported/enabled
  
  See Also:
  
  EngineWrapper.canSnapshot()
- closeListenerRegister
```
public void closeListenerRegister(java.lang.Runnable closeListener)
```
  Specified by:
  
  closeListenerRegister in interface Engine
- closeListenerUnregister
```
public void closeListenerUnregister(java.lang.Runnable closeListener)
```
  Specified by:
  
  closeListenerUnregister in interface Engine

Class Store

Field Summary

Fields inherited from interface org.mapdb.Engine

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.mapdb.Engine

Field Detail

LOG

checksum

compress

encrypt

password

encryptionXTEA

CHECKSUM_FLAG_MASK

COMPRESS_FLAG_MASK

ENCRYPT_FLAG_MASK

CHUNK_SIZE

CHUNK_SIZE_MOD_MASK

serializerPojo

LZF

serializerPojoInitLock

structuralLock

newRecidLock

locks

recycledDataOuts

LOCK_MASK

closeListeners

Constructor Detail

Store

Method Detail

getMaxRecid

getRaw

getFreeRecids

updateRaw

getSizeLimit

getCurrSize

getFreeSize

calculateStatistics

printStatistics

getSerializerPojo

lockAllWrite

unlockAllWrite

serialize

newDataOut2

deserialize

forDB

forEngine

expectedMasks

lockPos

canSnapshot

snapshot

closeListenerRegister

closeListenerUnregister