com.sleepycat.je.dbi

Class DbEnvPool

java.lang.Object

com.sleepycat.je.dbi.DbEnvPool

public class DbEnvPool
extends java.lang.Object

Singleton collection of environments. Responsible for environment open and close, supporting this from multiple threads by synchronizing on the pool. When synchronizing on two or more of the following objects the synchronization order must be as follows. Synchronization is not performed in constructors, of course, because no other thread can access the object. Synchronization order: Environment, DbEnvPool, EnvironmentImpl, Evictor Environment ctor NOT synchronized calls DbEnvPool.getEnvironment synchronized creates new EnvironmentImpl NOT synchronized calls RecoveryManager.recover,buildTree NOT synchronized calls Evictor.addEnvironment synchronized EnvironmentImpl.reinit NOT synchronized calls DbEnvPool.reinitEnvironment synchronized calls EnvironmentImpl.doReinit synchronized calls RecoveryManager.recover,buildTree NOT synchronized calls Evictor.addEnvironment synchronized Environment.close synchronized calls EnvironmentImpl.close NOT synchronized calls DbEnvPool.closeEnvironment synchronized calls EnvironmentImpl.doClose synchronized calls Evictor.removeEnvironment synchronized Environment.setMutableConfig synchronized calls EnvironmentImpl.setMutableConfig NOT synchronized calls DbEnvPool.setMutableConfig synchronized calls EnvironmentImpl.doSetMutableConfig synchronized

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() For unit testing only.
(package private) void	closeEnvironment(EnvironmentImpl envImpl, boolean doCheckpoint, boolean doCheckLeaks) Called by EnvironmentImpl.close to perform the close operation while synchronized on the DbEnvPool.
(package private) void	closeEnvironmentAfterRunRecovery(EnvironmentImpl envImpl) Called by EnvironmentImpl.closeAfterRunRecovery to perform the close operation while synchronized on the DbEnvPool.
EnvironmentImpl	getEnvironment(java.io.File envHome, EnvironmentConfig config, boolean checkImmutableParams, boolean openIfNeeded, boolean replicationIntended) Find a single environment, used by Environment handles and by command line utilities.
static DbEnvPool	getInstance() Access the singleton instance.
int	getNSharedCacheEnvironments()
(package private) void	reinitEnvironment(EnvironmentImpl envImpl, boolean replicationIntended) Called by EnvironmentImpl.reinit to perform the reinit operation while synchronized on the DbEnvPool.
(package private) void	setMutableConfig(EnvironmentImpl envImpl, EnvironmentMutableConfig mutableConfig) Called by EnvironmentImpl.setMutableConfig to perform the setMutableConfig operation while synchronized on the DbEnvPool.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static DbEnvPool getInstance()

Access the singleton instance.

getNSharedCacheEnvironments

public int getNSharedCacheEnvironments()

getEnvironment

public EnvironmentImpl getEnvironment(java.io.File envHome,
                             EnvironmentConfig config,
                             boolean checkImmutableParams,
                             boolean openIfNeeded,
                             boolean replicationIntended)
                               throws DatabaseException

Find a single environment, used by Environment handles and by command line utilities.

Throws:

DatabaseException

reinitEnvironment

void reinitEnvironment(EnvironmentImpl envImpl,
                     boolean replicationIntended)
                 throws DatabaseException

Called by EnvironmentImpl.reinit to perform the reinit operation while synchronized on the DbEnvPool.

Throws:

DatabaseException

setMutableConfig

void setMutableConfig(EnvironmentImpl envImpl,
                    EnvironmentMutableConfig mutableConfig)
                throws DatabaseException

Called by EnvironmentImpl.setMutableConfig to perform the setMutableConfig operation while synchronized on the DbEnvPool. In theory we shouldn't need to synchronize here when envImpl.getSharedCache() is false; however, we synchronize unconditionally to standardize the synchronization order and avoid accidental deadlocks.

Throws:

DatabaseException

closeEnvironment

void closeEnvironment(EnvironmentImpl envImpl,
                    boolean doCheckpoint,
                    boolean doCheckLeaks)
                throws DatabaseException

Called by EnvironmentImpl.close to perform the close operation while synchronized on the DbEnvPool.

Throws:

DatabaseException

closeEnvironmentAfterRunRecovery

void closeEnvironmentAfterRunRecovery(EnvironmentImpl envImpl)
                                throws DatabaseException

Called by EnvironmentImpl.closeAfterRunRecovery to perform the close operation while synchronized on the DbEnvPool.

Throws:

DatabaseException

clear

public void clear()

For unit testing only.