com.tangosol.io.bdb

Class DatabaseFactory

java.lang.Object

com.tangosol.util.Base

com.tangosol.io.bdb.DatabaseFactory

public class DatabaseFactory
extends Base

Factory for Berkeley DB Environments and Databases.

Temporary Environments will be automatically deleted upon JVM shutdown or GC.

Author:

mf 2005.10.04

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DatabaseFactory.EnvironmentHolder Holder for Berkeley DB Environment and its Databases.

Nested classes/interfaces inherited from class com.tangosol.util.Base

Base.LoggingWriter, Base.StackFrame

Field Summary

Fields

Modifier and Type	Field and Description
protected long	m_cDbId Counter used to generate unique Database names for this Environment.
protected com.sleepycat.je.DatabaseConfig	m_dbConfig Configuration to use when creating new Databases.
protected DatabaseFactory.EnvironmentHolder	m_envHolder Holder for Environment used to create Databases.

Fields inherited from class com.tangosol.util.Base

LOG_ALWAYS, LOG_DEBUG, LOG_ERR, LOG_INFO, LOG_MAX, LOG_MIN, LOG_QUIET, LOG_WARN, POWER_0, POWER_G, POWER_K, POWER_M, POWER_T, UNIT_D, UNIT_H, UNIT_M, UNIT_MS, UNIT_NS, UNIT_S, UNIT_US

Constructor Summary

Constructors

Constructor and Description
DatabaseFactory(BerkeleyDBBinaryStoreManager bdbManager) Construct a DatabaseFactory for a given Berkeley DB Environment.

Method Summary

Modifier and Type	Method and Description
com.sleepycat.je.Database	createNamedDatabase(String sName) Create a named Database instance.
protected void	finalize() Finalize for the DatabaseFactory.
void	forgetDatabase(com.sleepycat.je.Database db) Remove a database handle from the cleanup list.
com.sleepycat.je.DatabaseConfig	getDbConfig() Get the DatabaseConfiguration used to create Databases.
long	getDbIdCounter() Get the DB ID Counter value.
DatabaseFactory.EnvironmentHolder	getEnvHolder() Get the EnvironmentHolder.
String	getUniqueDbName() Get a unique (within the Factory) database name.
protected DatabaseFactory.EnvironmentHolder	instantiateEnvironment(BerkeleyDBBinaryStoreManager bdbManager) Create a EnvironmentHolder within the specified parent directory.
String	toString() Output the DatabaseFactory state as a String.

Methods inherited from class com.tangosol.util.Base

azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getProcessRandom, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mod, mod, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait

Methods inherited from class java.lang.Object

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

Field Detail

m_envHolder

protected DatabaseFactory.EnvironmentHolder m_envHolder

Holder for Environment used to create Databases.

m_dbConfig

protected com.sleepycat.je.DatabaseConfig m_dbConfig

Configuration to use when creating new Databases.

m_cDbId

protected long m_cDbId

Counter used to generate unique Database names for this Environment.

Constructor Detail

DatabaseFactory

public DatabaseFactory(BerkeleyDBBinaryStoreManager bdbManager)
                throws com.sleepycat.je.DatabaseException

Construct a DatabaseFactory for a given Berkeley DB Environment.

Berkeley DB Environments are bound to a single directory. Java File locking is used to ensure that only one JVM uses the Environment.

Parameters:

bdbManager - the BinaryStoreManager to create Databases for

Throws:

com.sleepycat.je.DatabaseException - if the Berkeley DB Environment could not be created

See Also:

Berkeley DB Configuration

Method Detail

toString

public String toString()

Output the DatabaseFactory state as a String.

Overrides:

toString in class Object

finalize

protected void finalize()
                 throws Throwable

Finalize for the DatabaseFactory.

When the factory is finalized it will force the EnvironmentHolder to be destroyed if it is temporary, and deregister the associated shutdown hook.

Overrides:

finalize in class Object

Throws:

Throwable

createNamedDatabase

public com.sleepycat.je.Database createNamedDatabase(String sName)
                                              throws com.sleepycat.je.DatabaseException

Create a named Database instance.

Parameters:

sName - the name of the database to create

Returns:

new a Database instance

Throws:

com.sleepycat.je.DatabaseException - if the Database creation failed

getUniqueDbName

public String getUniqueDbName()

Get a unique (within the Factory) database name.

Returns:

a unique database name

instantiateEnvironment

protected DatabaseFactory.EnvironmentHolder instantiateEnvironment(BerkeleyDBBinaryStoreManager bdbManager)
                                                            throws com.sleepycat.je.DatabaseException

Create a EnvironmentHolder within the specified parent directory.

Parameters:

bdbManager - the BinaryStore to create the environment for

Returns:

a new EnvironmentHolder

Throws:

com.sleepycat.je.DatabaseException - if the Environment could not be created

forgetDatabase

public void forgetDatabase(com.sleepycat.je.Database db)

Remove a database handle from the cleanup list.

Parameters:

db - the Database to remove from list

getEnvHolder

public DatabaseFactory.EnvironmentHolder getEnvHolder()

Get the EnvironmentHolder.

Returns:

the EnvironmentHolder

getDbConfig

public com.sleepycat.je.DatabaseConfig getDbConfig()

Get the DatabaseConfiguration used to create Databases.

Returns:

the DatabaseConfiguration

getDbIdCounter

public long getDbIdCounter()

Get the DB ID Counter value.

Returns:

the DB ID Counter value