Package org.dbunit

Class PropertiesBasedJdbcDatabaseTester

java.lang.Object

org.dbunit.assertion.SimpleAssert

org.dbunit.AbstractDatabaseTester

org.dbunit.JdbcDatabaseTester

org.dbunit.PropertiesBasedJdbcDatabaseTester

All Implemented Interfaces:

IDatabaseTester

public class PropertiesBasedJdbcDatabaseTester
extends JdbcDatabaseTester

DatabaseTester that configures a DriverManager from environment properties.
This class defines a set of keys for system properties that need to be present in the environment before using it. Example:

 System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_DRIVER_CLASS,
             "com.mycompany.myDriver" );
 System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_CONNECTION_URL,
             "jdbc:mydb://host/dbname" );
 System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_USERNAME,
             "myuser" );
 System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_PASSWORD,
             "mypasswd" );
 System.setProperty( PropertiesBasedJdbcDatabaseTester.DBUNIT_SCHEMA,
             "myschema" );
 

Since:

2.2.0

Version:

$Revision$ $Date$

Author:

Andres Almiray(aalmiray@users.sourceforge.net), Felipe Leme (dbunit@felipeal.net), Last changed by: $Author$

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DBUNIT_CONNECTION_URL	A key for property that defines the connection url
static final String	DBUNIT_DRIVER_CLASS	A key for property that defines the driver classname
static final String	DBUNIT_PASSWORD	A key for property that defines the user's password
static final String	DBUNIT_SCHEMA	A key for property that defines the database schema
static final String	DBUNIT_USERNAME	A key for property that defines the username

Constructor Summary

Constructors

Constructor	Description
PropertiesBasedJdbcDatabaseTester()	Creates a new JdbcDatabaseTester using specific System.getProperty(String) values as initialization parameters
PropertiesBasedJdbcDatabaseTester(CachingConnectionProvider connectionProvider)	Creates a new JdbcDatabaseTester using specific System.getProperty(String) values as initialization parameters, reusing one IDatabaseConnection across calls via the given CachingConnectionProvider instead of creating a new one on every call. Share the same connectionProvider instance across the testers created for each test to get reuse across test methods; pair it with IOperationListener.NO_OP_OPERATION_LISTENER (or an equivalent non-closing listener) so the cached connection is not closed after every AbstractDatabaseTester.onSetup()/AbstractDatabaseTester.onTearDown() call.

Method Summary

Methods inherited from class org.dbunit.JdbcDatabaseTester

getConnection, toString

Methods inherited from class org.dbunit.AbstractDatabaseTester

closeConnection, getDataSet, getSchema, getSetUpOperation, getTearDownOperation, onSetup, onTearDown, setDataSet, setOperationListener, setSchema, setSetUpOperation, setTearDownOperation

Methods inherited from class org.dbunit.assertion.SimpleAssert

assertNotNull, assertNotNull, assertNotNullNorEmpty, assertTrue, assertTrue, fail

Methods inherited from class java.lang.Object

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

Field Details

DBUNIT_CONNECTION_URL

public static final String DBUNIT_CONNECTION_URL

A key for property that defines the connection url

See Also:

• Constant Field Values

DBUNIT_DRIVER_CLASS

public static final String DBUNIT_DRIVER_CLASS

A key for property that defines the driver classname

See Also:

• Constant Field Values

DBUNIT_PASSWORD

public static final String DBUNIT_PASSWORD

A key for property that defines the user's password

See Also:

• Constant Field Values

DBUNIT_USERNAME

public static final String DBUNIT_USERNAME

A key for property that defines the username

See Also:

• Constant Field Values

DBUNIT_SCHEMA

public static final String DBUNIT_SCHEMA

A key for property that defines the database schema

See Also:

• Constant Field Values

Constructor Details

PropertiesBasedJdbcDatabaseTester

public PropertiesBasedJdbcDatabaseTester()
                                  throws Exception

Creates a new JdbcDatabaseTester using specific System.getProperty(String) values as initialization parameters

Throws:

Exception - if the configured driver class was not found.

PropertiesBasedJdbcDatabaseTester

public PropertiesBasedJdbcDatabaseTester(CachingConnectionProvider connectionProvider)
                                  throws Exception

Creates a new JdbcDatabaseTester using specific System.getProperty(String) values as initialization parameters, reusing one IDatabaseConnection across calls via the given CachingConnectionProvider instead of creating a new one on every call.
Share the same connectionProvider instance across the testers created for each test to get reuse across test methods; pair it with IOperationListener.NO_OP_OPERATION_LISTENER (or an equivalent non-closing listener) so the cached connection is not closed after every AbstractDatabaseTester.onSetup()/AbstractDatabaseTester.onTearDown() call.

Parameters:

connectionProvider - Caches and validates the connection across calls. Can be null, in which case a new connection is created on every call as before.

Throws:

Exception - if the configured driver class was not found.

Since:

3.4.0