voldemort.store.bdb
Class BdbStorageEngine

java.lang.Object
  voldemort.store.bdb.BdbStorageEngine

All Implemented Interfaces:

NativeBackupable, StorageEngine<ByteArray,byte[],byte[]>, Store<ByteArray,byte[],byte[]>

Direct Known Subclasses:

PartitionPrefixedBdbStorageEngine

public class BdbStorageEngine
extends java.lang.Object
implements StorageEngine<ByteArray,byte[],byte[]>, NativeBackupable

A store that uses BDB for persistence

Field Summary

protected BdbEnvironmentStats	bdbEnvironmentStats
protected boolean	checkpointerOffForBatchWrites
protected boolean	minimizeScanImpact

Constructor Summary

BdbStorageEngine(java.lang.String name, com.sleepycat.je.Environment environment, com.sleepycat.je.Database database, BdbRuntimeConfig config)

Method Summary

boolean	beginBatchModifications() A lot of storage engines support efficient methods for performing large number of writes (puts/deletes) against the data source.
void	close() Close the store.
boolean	delete(ByteArray key, Version version) Delete all entries prior to the given version
boolean	endBatchModifications()
ClosableIterator<Pair<ByteArray,Versioned<byte[]>>>	entries() Get an iterator over pairs of entries in the store.
ClosableIterator<Pair<ByteArray,Versioned<byte[]>>>	entries(int partition) Get an iterator over pairs of entries in a store's partition.
boolean	equals(java.lang.Object o)
java.util.List<Versioned<byte[]>>	get(ByteArray key, byte[] transforms) Get the value associated with the given key
java.util.Map<ByteArray,java.util.List<Versioned<byte[]>>>	getAll(java.lang.Iterable<ByteArray> keys, java.util.Map<ByteArray,byte[]> transforms) Get the values associated with the given keys and returns them in a Map of keys to a list of versioned values.
protected com.sleepycat.je.Database	getBdbDatabase() truncate() operation mandates that all opened Database be closed before attempting truncation.
BdbEnvironmentStats	getBdbEnvironmentStats()
java.lang.String	getBdbStats()
java.lang.String	getBdbStats(boolean fast)
java.lang.Object	getCapability(StoreCapabilityType capability) Get some capability of the store.
protected org.apache.log4j.Logger	getLogger()
java.lang.String	getName()
com.sleepycat.je.DatabaseStats	getStats(boolean setFast)
java.util.List<Version>	getVersions(ByteArray key)
int	hashCode()
boolean	isPartitionAware() Is the data persistence aware of partitions? In other words is the data internally stored on a per partition basis or together
boolean	isPartitionScanSupported() Does the storage engine support efficient scanning of a single partition
ClosableIterator<ByteArray>	keys() Get an iterator over keys in the store.
ClosableIterator<ByteArray>	keys(int partition) Get an iterator over keys in the store's partition Note that the iterator need not be threadsafe, and that it must be manually closed after use.
void	nativeBackup(java.io.File toDir, boolean verifyFiles, boolean isIncremental, AsyncOperationStatus status) Perform a native backup
void	put(ByteArray key, Versioned<byte[]> value, byte[] transforms) Associate the value with the key and version in this store
void	truncate() Truncate all entries in the store

Methods inherited from class java.lang.Object

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

Field Detail

bdbEnvironmentStats

protected final BdbEnvironmentStats bdbEnvironmentStats

minimizeScanImpact

protected final boolean minimizeScanImpact

checkpointerOffForBatchWrites

protected final boolean checkpointerOffForBatchWrites

Constructor Detail

BdbStorageEngine

public BdbStorageEngine(java.lang.String name,
                        com.sleepycat.je.Environment environment,
                        com.sleepycat.je.Database database,
                        BdbRuntimeConfig config)

Method Detail

getName

public java.lang.String getName()

Specified by:

getName in interface Store<ByteArray,byte[],byte[]>

Returns:

The name of the store.

entries

public ClosableIterator<Pair<ByteArray,Versioned<byte[]>>> entries()

Description copied from interface: StorageEngine

Get an iterator over pairs of entries in the store. The key is the first element in the pair and the versioned value is the second element. Note that the iterator need not be threadsafe, and that it must be manually closed after use.

Specified by:

entries in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

An iterator over the entries in this StorageEngine.

keys

public ClosableIterator<ByteArray> keys()

Description copied from interface: StorageEngine

Get an iterator over keys in the store. Note that the iterator need not be threadsafe, and that it must be manually closed after use.

Specified by:

keys in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

An iterator over the keys in this StorageEngine.

entries

public ClosableIterator<Pair<ByteArray,Versioned<byte[]>>> entries(int partition)

Description copied from interface: StorageEngine

Get an iterator over pairs of entries in a store's partition. The key is the first element in the pair and the versioned value is the second element. Note that the iterator need not be threadsafe, and that it must be manually closed after use.

Specified by:

entries in interface StorageEngine<ByteArray,byte[],byte[]>

Parameters:

partition - partition whose entries are to be fetched

Returns:

An iterator over the entries in this StorageEngine.

keys

public ClosableIterator<ByteArray> keys(int partition)

Description copied from interface: StorageEngine

Get an iterator over keys in the store's partition Note that the iterator need not be threadsafe, and that it must be manually closed after use.

Specified by:

keys in interface StorageEngine<ByteArray,byte[],byte[]>

Parameters:

partition - partition whose keys are to be fetched

Returns:

An iterator over the keys in this StorageEngine.

truncate

public void truncate()

Description copied from interface: StorageEngine

Truncate all entries in the store

Specified by:

truncate in interface StorageEngine<ByteArray,byte[],byte[]>

getBdbDatabase

protected com.sleepycat.je.Database getBdbDatabase()

truncate() operation mandates that all opened Database be closed before attempting truncation.

This method throws an exception while truncation is happening to any request attempting in parallel with store truncation.

Returns:

getVersions

public java.util.List<Version> getVersions(ByteArray key)

Specified by:

getVersions in interface Store<ByteArray,byte[],byte[]>

get

public java.util.List<Versioned<byte[]>> get(ByteArray key,
                                             byte[] transforms)
                                      throws PersistenceFailureException

Description copied from interface: Store

Get the value associated with the given key

Specified by:

get in interface Store<ByteArray,byte[],byte[]>

Parameters:

key - The key to check for

Returns:

The value associated with the key or an empty list if no values are found.

Throws:

PersistenceFailureException

getAll

public java.util.Map<ByteArray,java.util.List<Versioned<byte[]>>> getAll(java.lang.Iterable<ByteArray> keys,
                                                                         java.util.Map<ByteArray,byte[]> transforms)
                                                                  throws VoldemortException

Description copied from interface: Store

Get the values associated with the given keys and returns them in a Map of keys to a list of versioned values. Note that the returned map will only contain entries for the keys which have a value associated with them.

Specified by:

getAll in interface Store<ByteArray,byte[],byte[]>

Parameters:

keys - The keys to check for.

Returns:

A Map of keys to a list of versioned values.

Throws:

VoldemortException

put

public void put(ByteArray key,
                Versioned<byte[]> value,
                byte[] transforms)
         throws PersistenceFailureException

Description copied from interface: Store

Associate the value with the key and version in this store

Specified by:

put in interface Store<ByteArray,byte[],byte[]>

Parameters:

key - The key to use

value - The value to store and its version.

Throws:

PersistenceFailureException

delete

public boolean delete(ByteArray key,
                      Version version)
               throws PersistenceFailureException

Description copied from interface: Store

Delete all entries prior to the given version

Specified by:

delete in interface Store<ByteArray,byte[],byte[]>

Parameters:

key - The key to delete

version - The current value of the key

Returns:

True if anything was deleted

Throws:

PersistenceFailureException

getCapability

public java.lang.Object getCapability(StoreCapabilityType capability)

Description copied from interface: Store

Get some capability of the store. Examples would be the serializer used, or the routing strategy. This provides a mechanism to verify that the store hierarchy has some set of capabilities without knowing the precise layering.

Specified by:

getCapability in interface Store<ByteArray,byte[],byte[]>

Parameters:

capability - The capability type to retrieve

Returns:

The given capaiblity

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

close

public void close()
           throws PersistenceFailureException

Description copied from interface: Store

Close the store.

Specified by:

close in interface Store<ByteArray,byte[],byte[]>

Throws:

PersistenceFailureException

getStats

public com.sleepycat.je.DatabaseStats getStats(boolean setFast)

getBdbStats

public java.lang.String getBdbStats()

getBdbStats

public java.lang.String getBdbStats(boolean fast)

getBdbEnvironmentStats

public BdbEnvironmentStats getBdbEnvironmentStats()

getLogger

protected org.apache.log4j.Logger getLogger()

isPartitionAware

public boolean isPartitionAware()

Description copied from interface: StorageEngine

Is the data persistence aware of partitions? In other words is the data internally stored on a per partition basis or together

Specified by:

isPartitionAware in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

Boolean indicating if the data persistence is partition aware

isPartitionScanSupported

public boolean isPartitionScanSupported()

Description copied from interface: StorageEngine

Does the storage engine support efficient scanning of a single partition

Specified by:

isPartitionScanSupported in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

true if the storage engine implements the capability. false otherwise

nativeBackup

public void nativeBackup(java.io.File toDir,
                         boolean verifyFiles,
                         boolean isIncremental,
                         AsyncOperationStatus status)

Description copied from interface: NativeBackupable

Perform a native backup

Specified by:

nativeBackup in interface NativeBackupable

Parameters:

toDir - The directory to backup to

verifyFiles - whether the integrity of the copied data needs to be verified

isIncremental - is the backup incremental

status - The async operation status to update/check

beginBatchModifications

public boolean beginBatchModifications()

Description copied from interface: StorageEngine

A lot of storage engines support efficient methods for performing large number of writes (puts/deletes) against the data source. This method puts the storage engine in this batch write mode

Specified by:

beginBatchModifications in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

true if the storage engine took successful action to switch to 'batch-write' mode

endBatchModifications

public boolean endBatchModifications()

Specified by:

endBatchModifications in interface StorageEngine<ByteArray,byte[],byte[]>

Returns:

true if the storage engine successfully returned to normal mode