Package com.db4o

Class Db4oEmbedded

java.lang.Object

com.db4o.Db4oEmbedded

public class Db4oEmbedded
extends java.lang.Object

Factory class to open db4o instances in embedded mode.

For client server scenarious please use the com.db4o.cs.Db4oClientServer factory from the db4o-cs-java.jar for methods to open db4o servers and db4o clients.

Since:

7.5

Constructor Summary

Constructors

Constructor	Description
Db4oEmbedded()

Method Summary

Modifier and Type	Method	Description
static EmbeddedConfiguration	newConfiguration()	Creates a fresh EmbeddedConfiguration instance.
static EmbeddedObjectContainer	openFile(EmbeddedConfiguration config, java.lang.String databaseFileName)	Opens an ObjectContainer on the specified database file for local use.
static EmbeddedObjectContainer	openFile(java.lang.String databaseFileName)	Same (from java) as calling openFile(EmbeddedConfiguration, String) with a fresh configuration (newConfiguration()).

Methods inherited from class java.lang.Object

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

Constructor Detail

Db4oEmbedded

public Db4oEmbedded()

Method Detail

newConfiguration

public static EmbeddedConfiguration newConfiguration()

Creates a fresh EmbeddedConfiguration instance.

Returns:

a fresh, independent configuration with all options set to their default values

openFile

public static final EmbeddedObjectContainer openFile(EmbeddedConfiguration config,
                                                     java.lang.String databaseFileName)
                                              throws Db4oIOException,
                                                     DatabaseFileLockedException,
                                                     IncompatibleFileFormatException,
                                                     OldFormatException,
                                                     DatabaseReadOnlyException

Opens an ObjectContainer on the specified database file for local use.

Database files can only be accessed for access from one process at one time. Subsequent attempts to open the same file will result in a DatabaseFileLockedException.
For multiple object containers against the same database use the ObjectContainer.ext().openSession()() method. Or use the client server mode from the db4o-cs-java.jar

Parameters:

config - a EmbeddedConfiguration instance to be obtained via newConfiguration()

databaseFileName - an absolute or relative path to the database file

Returns:

an open ObjectContainer

Throws:

Db4oIOException - I/O operation failed or was unexpectedly interrupted.

DatabaseFileLockedException - the required database file is locked by another process.

IncompatibleFileFormatException - runtime configuration is not compatible with the configuration of the database file.

OldFormatException - open operation failed because the database file is in old format and CommonConfiguration.allowVersionUpdates(boolean) is set to false.

DatabaseReadOnlyException - database was configured as read-only.

openFile

public static final EmbeddedObjectContainer openFile(java.lang.String databaseFileName)
                                              throws Db4oIOException,
                                                     DatabaseFileLockedException,
                                                     IncompatibleFileFormatException,
                                                     OldFormatException,
                                                     DatabaseReadOnlyException

Same (from java) as calling openFile(EmbeddedConfiguration, String) with a fresh configuration (newConfiguration()).

Parameters:

databaseFileName - an absolute or relative path to the database file

Throws:

Db4oIOException

DatabaseFileLockedException

IncompatibleFileFormatException

OldFormatException

DatabaseReadOnlyException

See Also:

openFile(EmbeddedConfiguration, String)