org.springframework.jdbc.datasource.embedded

Class EmbeddedDatabaseFactory

java.lang.Object

org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory

Direct Known Subclasses:

EmbeddedDatabaseFactoryBean

public class EmbeddedDatabaseFactory
extends java.lang.Object

Factory for creating EmbeddedDatabase instances.

Callers are guaranteed that a returned database has been fully initialized and populated.

Can be configured:

• Call setDatabaseName(String) to change the name of the database.
• Call setDatabaseType(EmbeddedDatabaseType) to set the database type if you wish to use one of the supported types.
• Call setDatabaseConfigurer(EmbeddedDatabaseConfigurer) to configure support for your own embedded database type.
• Call setDatabasePopulator(DatabasePopulator) to change the algorithm used to populate the database.
• Call setDataSourceFactory(DataSourceFactory) to change the type of DataSource used to connect to the database.

Call getDatabase() to get the EmbeddedDatabase instance.

Since:

3.0

Author:

Keith Donald, Juergen Hoeller, Sam Brannen

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_DATABASE_NAME Default name for an embedded database: "testdb".

Constructor Summary

Constructors

Constructor and Description
EmbeddedDatabaseFactory()

Method Summary

Modifier and Type	Method and Description
EmbeddedDatabase	getDatabase() Factory method that returns the embedded database instance, which is also a DataSource.
protected javax.sql.DataSource	getDataSource() Hook that gets the DataSource that provides the connectivity to the embedded database.
protected void	initDatabase() Hook to initialize the embedded database.
void	setDatabaseConfigurer(EmbeddedDatabaseConfigurer configurer) Set the strategy that will be used to configure the embedded database instance.
void	setDatabaseName(java.lang.String databaseName) Set the name of the database.
void	setDatabasePopulator(DatabasePopulator populator) Set the strategy that will be used to initialize or populate the embedded database.
void	setDatabaseType(EmbeddedDatabaseType type) Set the type of embedded database to use.
void	setDataSourceFactory(DataSourceFactory dataSourceFactory) Set the factory to use to create the DataSource instance that connects to the embedded database.
protected void	shutdownDatabase() Hook to shutdown the embedded database.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_DATABASE_NAME

public static final java.lang.String DEFAULT_DATABASE_NAME

Default name for an embedded database: "testdb".

See Also:

Constant Field Values

Constructor Detail

EmbeddedDatabaseFactory

public EmbeddedDatabaseFactory()

Method Detail

setDatabaseName

public void setDatabaseName(java.lang.String databaseName)

Set the name of the database.

Defaults to "testdb".

Parameters:

databaseName - name of the embedded database

setDataSourceFactory

public void setDataSourceFactory(DataSourceFactory dataSourceFactory)

Set the factory to use to create the DataSource instance that connects to the embedded database.

Defaults to SimpleDriverDataSourceFactory.

setDatabaseType

public void setDatabaseType(EmbeddedDatabaseType type)

Set the type of embedded database to use.

Call this when you wish to configure one of the pre-supported types.

Defaults to HSQL.

Parameters:

type - the database type

setDatabaseConfigurer

public void setDatabaseConfigurer(EmbeddedDatabaseConfigurer configurer)

Set the strategy that will be used to configure the embedded database instance.

Call this when you wish to use an embedded database type not already supported.

setDatabasePopulator

public void setDatabasePopulator(DatabasePopulator populator)

Set the strategy that will be used to initialize or populate the embedded database.

Defaults to null.

getDatabase

public EmbeddedDatabase getDatabase()

Factory method that returns the embedded database instance, which is also a DataSource.

initDatabase

protected void initDatabase()

Hook to initialize the embedded database. Subclasses may call this method to force initialization.

After calling this method, getDataSource() returns the DataSource providing connectivity to the database.

shutdownDatabase

protected void shutdownDatabase()

Hook to shutdown the embedded database. Subclasses may call this method to force shutdown.

After calling, getDataSource() returns null.

Does nothing if no embedded database has been initialized.

getDataSource

protected final javax.sql.DataSource getDataSource()

Hook that gets the DataSource that provides the connectivity to the embedded database.

Returns null if the DataSource has not been initialized or if the database has been shut down. Subclasses may call this method to access the DataSource instance directly.