Package one.microstream.storage.configuration

Class Configuration.Default

java.lang.Object

one.microstream.storage.configuration.Configuration.Default

All Implemented Interfaces:

Configuration

Enclosing interface:

Configuration

public static class Configuration.Default
extends Object
implements Configuration

Nested Class Summary

Nested classes/interfaces inherited from interface one.microstream.storage.configuration.Configuration

Configuration.Default

Constructor Summary

Constructors

Constructor	Description
Default()

Method Summary

Modifier and Type	Method	Description
String	getBackupDirectory()	The backup directory.
String	getBaseDirectory()	The base directory of the storage in the file system.
int	getChannelCount()	The number of threads and number of directories used by the storage engine.
String	getChannelDirectoryPrefix()	Name prefix of the subdirectories used by the channel threads.
double	getDataFileDissolveRatio()	The degree of the data payload of a storage file to avoid cleaning it up.
int	getDataFileMaxSize()	Maximum file size for a data file to avoid cleaning it up.
int	getDataFileMinSize()	Minimum file size for a data file to avoid cleaning it up.
String	getDataFilePrefix()	Name prefix of the storage files.
String	getDataFileSuffix()	Name suffix of the storage files.
String	getDeletionDirectory()	The deletion directory.
long	getEntityCacheThreshold()	Abstract threshold value for the lifetime of entities in the cache.
long	getEntityCacheTimeout()	Timeout in milliseconds for the entity cache evaluator.
long	getHouseKeepingInterval()	Interval in milliseconds for the houskeeping.
long	getHouseKeepingNanoTimeBudget()	Number of nanoseconds used for each housekeeping cycle.
String	getTransactionFilePrefix()	Name prefix of the storage transaction file.
String	getTransactionFileSuffix()	Name suffix of the storage transaction file.
String	getTruncationDirectory()	The truncation directory.
String	getTypeDictionaryFilename()	The name of the dictionary file.
Configuration	setBackupDirectory(String backupDirectory)	The backup directory.
Configuration	setBaseDirectory(String baseDirectory)	The base directory of the storage in the file system.
Configuration	setChannelCount(int channelCount)	The number of threads and number of directories used by the storage engine.
Configuration	setChannelDirectoryPrefix(String channelDirectoryPrefix)	Name prefix of the subdirectories used by the channel threads.
Configuration	setDataFileDissolveRatio(double dataFileDissolveRatio)	The degree of the data payload of a storage file to avoid cleaning it up.
Configuration	setDataFileMaxSize(int dataFileMaxSize)	Maximum file size for a data file to avoid cleaning it up.
Configuration	setDataFileMinSize(int dataFileMinSize)	Minimum file size for a data file to avoid cleaning it up.
Configuration	setDataFilePrefix(String dataFilePrefix)	Name prefix of the storage files.
Configuration	setDataFileSuffix(String dataFileSuffix)	Name suffix of the storage files.
Configuration	setDeletionDirectory(String deletionDirectory)	The deletion directory.
Configuration	setEntityCacheThreshold(long entityCacheThreshold)	Abstract threshold value for the lifetime of entities in the cache.
Configuration	setEntityCacheTimeout(long entityCacheTimeout)	Timeout in milliseconds for the entity cache evaluator.
Configuration	setHouseKeepingInterval(long houseKeepingInterval)	Interval in milliseconds for the houskeeping.
Configuration	setHouseKeepingNanoTimeBudget(long houseKeepingNanoTimeBudget)	Number of nanoseconds used for each housekeeping cycle.
Configuration	setTransactionFilePrefix(String transactionFilePrefix)	Name prefix of the storage transaction file.
Configuration	setTransactionFileSuffix(String transactionFileSuffix)	Name suffix of the storage transaction file.
Configuration	setTruncationDirectory(String truncationDirectory)	The truncation directory.
Configuration	setTypeDictionaryFilename(String typeDictionaryFilename)	The name of the dictionary file.

Methods inherited from class java.lang.Object

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

Methods inherited from interface one.microstream.storage.configuration.Configuration

createEmbeddedStorageFoundation, setBackupDirectoryInUserHome, setBaseDirectoryInUserHome

Constructor Detail

Default

public Default()

Method Detail

setBaseDirectory

public Configuration setBaseDirectory(String baseDirectory)

Description copied from interface: Configuration

The base directory of the storage in the file system.

Specified by:

setBaseDirectory in interface Configuration

getBaseDirectory

public String getBaseDirectory()

Description copied from interface: Configuration

The base directory of the storage in the file system.

Specified by:

getBaseDirectory in interface Configuration

setDeletionDirectory

public Configuration setDeletionDirectory(String deletionDirectory)

Description copied from interface: Configuration

The deletion directory.

Specified by:

setDeletionDirectory in interface Configuration

getDeletionDirectory

public String getDeletionDirectory()

Description copied from interface: Configuration

The deletion directory.

Specified by:

getDeletionDirectory in interface Configuration

setTruncationDirectory

public Configuration setTruncationDirectory(String truncationDirectory)

Description copied from interface: Configuration

The truncation directory.

Specified by:

setTruncationDirectory in interface Configuration

getTruncationDirectory

public String getTruncationDirectory()

Description copied from interface: Configuration

The truncation directory.

Specified by:

getTruncationDirectory in interface Configuration

setBackupDirectory

public Configuration setBackupDirectory(String backupDirectory)

Description copied from interface: Configuration

The backup directory.

Specified by:

setBackupDirectory in interface Configuration

getBackupDirectory

public String getBackupDirectory()

Description copied from interface: Configuration

The backup directory.

Specified by:

getBackupDirectory in interface Configuration

setChannelCount

public Configuration setChannelCount(int channelCount)

Description copied from interface: Configuration

The number of threads and number of directories used by the storage engine. Every thread has exclusive access to its directory. Default is 1.

Specified by:

setChannelCount in interface Configuration

Parameters:

channelCount - the new channel count, must be a power of 2

getChannelCount

public int getChannelCount()

Description copied from interface: Configuration

The number of threads and number of directories used by the storage engine. Every thread has exclusive access to its directory.

Specified by:

getChannelCount in interface Configuration

setChannelDirectoryPrefix

public Configuration setChannelDirectoryPrefix(String channelDirectoryPrefix)

Description copied from interface: Configuration

Name prefix of the subdirectories used by the channel threads. Default is "channel_".

Specified by:

setChannelDirectoryPrefix in interface Configuration

Parameters:

channelDirectoryPrefix - new prefix

getChannelDirectoryPrefix

public String getChannelDirectoryPrefix()

Description copied from interface: Configuration

Name prefix of the subdirectories used by the channel threads.

Specified by:

getChannelDirectoryPrefix in interface Configuration

setDataFilePrefix

public Configuration setDataFilePrefix(String dataFilePrefix)

Description copied from interface: Configuration

Name prefix of the storage files. Default is "channel_".

Specified by:

setDataFilePrefix in interface Configuration

Parameters:

dataFilePrefix - new prefix

getDataFilePrefix

public String getDataFilePrefix()

Description copied from interface: Configuration

Name prefix of the storage files.

Specified by:

getDataFilePrefix in interface Configuration

setDataFileSuffix

public Configuration setDataFileSuffix(String dataFileSuffix)

Description copied from interface: Configuration

Name suffix of the storage files. Default is ".dat".

Specified by:

setDataFileSuffix in interface Configuration

Parameters:

dataFileSuffix - new suffix

getDataFileSuffix

public String getDataFileSuffix()

Description copied from interface: Configuration

Name suffix of the storage files.

Specified by:

getDataFileSuffix in interface Configuration

setTransactionFilePrefix

public Configuration setTransactionFilePrefix(String transactionFilePrefix)

Description copied from interface: Configuration

Name prefix of the storage transaction file. Default is "transactions_".

Specified by:

setTransactionFilePrefix in interface Configuration

Parameters:

transactionFilePrefix - new prefix

getTransactionFilePrefix

public String getTransactionFilePrefix()

Description copied from interface: Configuration

Name prefix of the storage transaction file.

Specified by:

getTransactionFilePrefix in interface Configuration

setTransactionFileSuffix

public Configuration setTransactionFileSuffix(String transactionFileSuffix)

Description copied from interface: Configuration

Name suffix of the storage transaction file. Default is ".sft".

Specified by:

setTransactionFileSuffix in interface Configuration

Parameters:

transactionFileSuffix - new suffix

getTransactionFileSuffix

public String getTransactionFileSuffix()

Description copied from interface: Configuration

Name suffix of the storage transaction file.

Specified by:

getTransactionFileSuffix in interface Configuration

setTypeDictionaryFilename

public Configuration setTypeDictionaryFilename(String typeDictionaryFilename)

Description copied from interface: Configuration

The name of the dictionary file. Default is "PersistenceTypeDictionary.ptd".

Specified by:

setTypeDictionaryFilename in interface Configuration

Parameters:

typeDictionaryFilename - new name

getTypeDictionaryFilename

public String getTypeDictionaryFilename()

Description copied from interface: Configuration

The name of the dictionary file.

Specified by:

getTypeDictionaryFilename in interface Configuration

setHouseKeepingInterval

public Configuration setHouseKeepingInterval(long houseKeepingInterval)

Description copied from interface: Configuration

Interval in milliseconds for the houskeeping. This is work like garbage collection or cache checking. In combination with Configuration.setHouseKeepingNanoTimeBudget(long) the maximum processor time for housekeeping work can be set. Default is 1000 (every second).

Specified by:

setHouseKeepingInterval in interface Configuration

Parameters:

houseKeepingInterval - the new interval

See Also:

Configuration.setHouseKeepingNanoTimeBudget(long)

getHouseKeepingInterval

public long getHouseKeepingInterval()

Description copied from interface: Configuration

Interval in milliseconds for the houskeeping. This is work like garbage collection or cache checking.

Specified by:

getHouseKeepingInterval in interface Configuration

See Also:

Configuration.getHouseKeepingNanoTimeBudget()

setHouseKeepingNanoTimeBudget

public Configuration setHouseKeepingNanoTimeBudget(long houseKeepingNanoTimeBudget)

Description copied from interface: Configuration

Number of nanoseconds used for each housekeeping cycle. However, no matter how low the number is, one item of work will always be completed. But if there is nothing to clean up, no processor time will be wasted. Default is 10000000 (10 million nanoseconds = 10 milliseconds = 0.01 seconds).

Specified by:

setHouseKeepingNanoTimeBudget in interface Configuration

Parameters:

houseKeepingNanoTimeBudget - the new time budget

See Also:

Configuration.setHouseKeepingInterval(long)

getHouseKeepingNanoTimeBudget

public long getHouseKeepingNanoTimeBudget()

Description copied from interface: Configuration

Number of nanoseconds used for each housekeeping cycle. However, no matter how low the number is, one item of work will always be completed. But if there is nothing to clean up, no processor time will be wasted.

Specified by:

getHouseKeepingNanoTimeBudget in interface Configuration

See Also:

Configuration.getHouseKeepingInterval()

setEntityCacheThreshold

public Configuration setEntityCacheThreshold(long entityCacheThreshold)

Description copied from interface: Configuration

Abstract threshold value for the lifetime of entities in the cache. See StorageEntityCacheEvaluator. Default is 1000000000.

Specified by:

setEntityCacheThreshold in interface Configuration

Parameters:

entityCacheThreshold - the new threshold

getEntityCacheThreshold

public long getEntityCacheThreshold()

Description copied from interface: Configuration

Abstract threshold value for the lifetime of entities in the cache. See StorageEntityCacheEvaluator.

Specified by:

getEntityCacheThreshold in interface Configuration

setEntityCacheTimeout

public Configuration setEntityCacheTimeout(long entityCacheTimeout)

Description copied from interface: Configuration

Timeout in milliseconds for the entity cache evaluator. If an entity wasn't accessed in this timespan it will be removed from the cache. Default is 86400000 (1 day).

Specified by:

setEntityCacheTimeout in interface Configuration

See Also:

Duration

getEntityCacheTimeout

public long getEntityCacheTimeout()

Description copied from interface: Configuration

Timeout in milliseconds for the entity cache evaluator. If an entity wasn't accessed in this timespan it will be removed from the cache.

Specified by:

getEntityCacheTimeout in interface Configuration

setDataFileMinSize

public Configuration setDataFileMinSize(int dataFileMinSize)

Description copied from interface: Configuration

Minimum file size for a data file to avoid cleaning it up. Default is 1024^2 = 1 MiB.

Specified by:

setDataFileMinSize in interface Configuration

Parameters:

dataFileMinSize - the new minimum file size

See Also:

Configuration.setDataFileDissolveRatio(double)

getDataFileMinSize

public int getDataFileMinSize()

Description copied from interface: Configuration

Minimum file size for a data file to avoid cleaning it up.

Specified by:

getDataFileMinSize in interface Configuration

See Also:

Configuration.getDataFileDissolveRatio()

setDataFileMaxSize

public Configuration setDataFileMaxSize(int dataFileMaxSize)

Description copied from interface: Configuration

Maximum file size for a data file to avoid cleaning it up. Default is 1024^2*8 = 8 MiB.

Specified by:

setDataFileMaxSize in interface Configuration

Parameters:

dataFileMaxSize - the new maximum file size

See Also:

Configuration.setDataFileDissolveRatio(double)

getDataFileMaxSize

public int getDataFileMaxSize()

Description copied from interface: Configuration

Maximum file size for a data file to avoid cleaning it up.

Specified by:

getDataFileMaxSize in interface Configuration

See Also:

Configuration.getDataFileDissolveRatio()

setDataFileDissolveRatio

public Configuration setDataFileDissolveRatio(double dataFileDissolveRatio)

Description copied from interface: Configuration

The degree of the data payload of a storage file to avoid cleaning it up. The storage engine only appends newly written records at the end of a channel. So no data will be overwritten but becomes obsolete (gaps). If all data file evaluator settings apply to a storage file it will be cleaned up. Meaning all valid records will be preserved by moving them to the end of the channel, then the file will be deleted.
Dissolve Ratio 1: If the first gap appears, the file will be cleaned up
Dissolve Ratio 0: Gaps don't matter, never clean up
Default is 0.75 (0.75%).

Specified by:

setDataFileDissolveRatio in interface Configuration

Parameters:

dataFileDissolveRatio - the new dissolve ration

getDataFileDissolveRatio

public double getDataFileDissolveRatio()

Description copied from interface: Configuration

The degree of the data payload of a storage file to avoid cleaning it up. The storage engine only appends newly written records at the end of a channel. So no data will be overwritten but becomes obsolete (gaps). If all data file evaluator settings apply to a storage file it will be cleaned up. Meaning all valid records will be preserved by moving them to the end of the channel, then the file will be deleted.
Dissolve Ratio 1: If the first gap appears, the file will be cleaned up
Dissolve Ratio 0: Gaps don't matter, never clean up

Specified by:

getDataFileDissolveRatio in interface Configuration