org.springframework.jdbc.datasource.init

Class CompositeDatabasePopulator

java.lang.Object

org.springframework.jdbc.datasource.init.CompositeDatabasePopulator

All Implemented Interfaces:

DatabasePopulator

public class CompositeDatabasePopulator
extends Object
implements DatabasePopulator

DatabasePopulator implementation that delegates to a list of other DatabasePopulator implementations, executing all scripts.

Since:

3.1

Author:

Dave Syer, Juergen Hoeller, Sam Brannen

Constructor Summary

Constructors

Constructor and Description
CompositeDatabasePopulator()

Method Summary

Modifier and Type	Method and Description
void	addPopulators(DatabasePopulator... populators) Add one or more populators to the list of delegates.
void	populate(Connection connection) Populate, initialize, or clean up the database using the provided JDBC connection.
void	setPopulators(DatabasePopulator... populators) Specify a list of populators to delegate to.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeDatabasePopulator

public CompositeDatabasePopulator()

Method Detail

setPopulators

public void setPopulators(DatabasePopulator... populators)

Specify a list of populators to delegate to.

addPopulators

public void addPopulators(DatabasePopulator... populators)

Add one or more populators to the list of delegates.

populate

public void populate(Connection connection)
              throws SQLException,
                     ScriptException

Populate, initialize, or clean up the database using the provided JDBC connection.

Concrete implementations may throw an SQLException if an error is encountered but are strongly encouraged to throw a specific ScriptException instead. For example, Spring's ResourceDatabasePopulator and DatabasePopulatorUtils wrap all SQLExceptions in ScriptExceptions.

Specified by:

populate in interface DatabasePopulator

Parameters:

connection - the JDBC connection to use to populate the db; already configured and ready to use; never null

Throws:

SQLException - if an unrecoverable data access exception occurs during database population

ScriptException - in all other error cases

See Also:

DatabasePopulatorUtils.execute(org.springframework.jdbc.datasource.init.DatabasePopulator, javax.sql.DataSource)