public abstract class

AbstractTransactionalDataSourceSpringContextTests

extends AbstractTransactionalSpringContextTests

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	org.springframework.test.ConditionalTestCase
			↳	org.springframework.test.AbstractSpringContextTests
				↳	org.springframework.test.AbstractSingleSpringContextTests
					↳	org.springframework.test.AbstractDependencyInjectionSpringContextTests
						↳	org.springframework.test.AbstractTransactionalSpringContextTests
							↳	org.springframework.test.AbstractTransactionalDataSourceSpringContextTests

Known Direct Subclasses

AbstractAnnotationAwareTransactionalTests

Known Indirect Subclasses

AbstractAspectjJpaTests, AbstractJpaTests

This class is deprecated.
as of Spring 3.0, in favor of using the listener-based test context framework (AbstractJUnit38SpringContextTests)

Class Overview

Subclass of AbstractTransactionalSpringContextTests that adds some convenience functionality for JDBC access. Expects a javax.sql.DataSource bean to be defined in the Spring application context.

This class exposes a JdbcTemplate and provides an easy way to delete from the database in a new transaction.

Summary

[Expand]

Inherited Constants

From class org.springframework.test.AbstractDependencyInjectionSpringContextTests

Fields
protected JdbcTemplate	jdbcTemplate

[Expand]

Inherited Fields

From class org.springframework.test.AbstractTransactionalSpringContextTests

From class org.springframework.test.AbstractSingleSpringContextTests

From class org.springframework.test.ConditionalTestCase

Public Constructors
	AbstractTransactionalDataSourceSpringContextTests() Default constructor for AbstractTransactionalDataSourceSpringContextTests.
	AbstractTransactionalDataSourceSpringContextTests(String name) Constructor for AbstractTransactionalDataSourceSpringContextTests with a JUnit name.

Public Methods
final JdbcTemplate	getJdbcTemplate() Return the JdbcTemplate that this base class manages.
void	setDataSource(DataSource dataSource) Setter: DataSource is provided by Dependency Injection.
void	setSqlScriptEncoding(String sqlScriptEncoding) Specify the encoding for SQL scripts, if different from the platform encoding.

Protected Methods
int	countRowsInTable(String tableName) Count the rows in the given table
void	deleteFromTables(String[] names) Convenient method to delete all rows from these tables.
void	executeSqlScript(String sqlResourcePath, boolean continueOnError) Execute the given SQL script.
final void	setComplete() Overridden to prevent the transaction committing if a number of tables have been cleared, as a defensive measure against accidental permanent wiping of a database.

[Expand]

Inherited Methods

From class org.springframework.test.AbstractTransactionalSpringContextTests

void	endTransaction() Immediately force a commit or rollback of the transaction, according to the `complete` and `rollback` flags.
boolean	isDefaultRollback() Get the default rollback flag for this test.
boolean	isRollback() Determines whether or not to rollback transactions for the current test.
void	onSetUp() This implementation creates a transaction before test execution.
void	onSetUpBeforeTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, before the transaction created by this class.
void	onSetUpInTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, within the transaction created by this class.
void	onTearDown() This implementation ends the transaction after test execution.
void	onTearDownAfterTransaction() Subclasses can override this method to perform cleanup after a transaction here.
void	onTearDownInTransaction() Subclasses can override this method to run invariant tests here.
void	preventTransaction() Call this method in an overridden `runBare()` method to prevent transactional execution.
void	setComplete() Cause the transaction to commit for this test method, even if the test method is configured to `rollback`.
void	setDefaultRollback(boolean defaultRollback) Subclasses can set this value in their constructor to change the default, which is always to roll the transaction back.
void	setTransactionDefinition(TransactionDefinition customDefinition) Call this method in an overridden `runBare()` method to override the transaction attributes that will be used, so that `setUp()` and `tearDown()` behavior is modified.
void	setTransactionManager(PlatformTransactionManager transactionManager) Specify the transaction manager to use.
void	startNewTransaction() Start a new transaction.

From class org.springframework.test.AbstractDependencyInjectionSpringContextTests

final int	getAutowireMode() Return the autowire mode for test properties set by Dependency Injection.
void	injectDependencies() Inject dependencies into 'this' instance (that is, this test instance).
final boolean	isDependencyCheck() Return whether or not dependency checking should be performed for test properties set by Dependency Injection.
final boolean	isPopulateProtectedVariables() Return whether to populate protected variables of this test case.
void	prepareTestInstance() Prepare this test instance, injecting dependencies into its protected fields and its bean properties.
final void	setAutowireMode(int autowireMode) Set the autowire mode for test properties set by Dependency Injection.
final void	setDependencyCheck(boolean dependencyCheck) Set whether or not dependency checking should be performed for test properties set by Dependency Injection.
final void	setPopulateProtectedVariables(boolean populateFields) Set whether to populate protected variables of this test case.

From class org.springframework.test.AbstractSingleSpringContextTests

From class org.springframework.test.AbstractSpringContextTests

From class org.springframework.test.ConditionalTestCase

From class junit.framework.TestCase

From class junit.framework.Assert

static void	assertEquals(short arg0, short arg1)
static void	assertEquals(String arg0, int arg1, int arg2)
static void	assertEquals(String arg0, short arg1, short arg2)
static void	assertEquals(char arg0, char arg1)
static void	assertEquals(String arg0, String arg1, String arg2)
static void	assertEquals(int arg0, int arg1)
static void	assertEquals(String arg0, double arg1, double arg2, double arg3)
static void	assertEquals(String arg0, long arg1, long arg2)
static void	assertEquals(byte arg0, byte arg1)
static void	assertEquals(Object arg0, Object arg1)
static void	assertEquals(boolean arg0, boolean arg1)
static void	assertEquals(String arg0, float arg1, float arg2, float arg3)
static void	assertEquals(String arg0, boolean arg1, boolean arg2)
static void	assertEquals(String arg0, String arg1)
static void	assertEquals(float arg0, float arg1, float arg2)
static void	assertEquals(String arg0, byte arg1, byte arg2)
static void	assertEquals(double arg0, double arg1, double arg2)
static void	assertEquals(String arg0, char arg1, char arg2)
static void	assertEquals(String arg0, Object arg1, Object arg2)
static void	assertEquals(long arg0, long arg1)
static void	assertFalse(String arg0, boolean arg1)
static void	assertFalse(boolean arg0)
static void	assertNotNull(String arg0, Object arg1)
static void	assertNotNull(Object arg0)
static void	assertNotSame(Object arg0, Object arg1)
static void	assertNotSame(String arg0, Object arg1, Object arg2)
static void	assertNull(Object arg0)
static void	assertNull(String arg0, Object arg1)
static void	assertSame(Object arg0, Object arg1)
static void	assertSame(String arg0, Object arg1, Object arg2)
static void	assertTrue(String arg0, boolean arg1)
static void	assertTrue(boolean arg0)
static void	fail(String arg0)
static void	fail()
static void	failNotEquals(String arg0, Object arg1, Object arg2)
static void	failNotSame(String arg0, Object arg1, Object arg2)
static void	failSame(String arg0)
static String	format(String arg0, Object arg1, Object arg2)

From class java.lang.Object

From interface junit.framework.Test

Fields

protected JdbcTemplate jdbcTemplate

Public Constructors

public AbstractTransactionalDataSourceSpringContextTests ()

Default constructor for AbstractTransactionalDataSourceSpringContextTests.

public AbstractTransactionalDataSourceSpringContextTests (String name)

Constructor for AbstractTransactionalDataSourceSpringContextTests with a JUnit name.

Public Methods

public final JdbcTemplate getJdbcTemplate ()

Return the JdbcTemplate that this base class manages.

public void setDataSource (DataSource dataSource)

Setter: DataSource is provided by Dependency Injection.

public void setSqlScriptEncoding (String sqlScriptEncoding)

Specify the encoding for SQL scripts, if different from the platform encoding.

Protected Methods

protected int countRowsInTable (String tableName)

Count the rows in the given table

Parameters

tableName	table name to count rows in

Returns

the number of rows in the table

protected void deleteFromTables (String[] names)

Convenient method to delete all rows from these tables. Calling this method will make avoidance of rollback by calling setComplete() impossible.

protected void executeSqlScript (String sqlResourcePath, boolean continueOnError)

Execute the given SQL script. Will be rolled back by default, according to the fate of the current transaction.

Parameters

sqlResourcePath

Spring resource path for the SQL script. Should normally be loaded by classpath.

Statements should be delimited with a semicolon. If statements are not delimited with a semicolon then there should be one statement per line. Statements are allowed to span lines only if they are delimited with a semicolon.

Do not use this method to execute DDL if you expect rollback.

continueOnError

whether or not to continue without throwing an exception in the event of an error

Throws

DataAccessException	if there is an error executing a statement and continueOnError was false

protected final void setComplete ()

Overridden to prevent the transaction committing if a number of tables have been cleared, as a defensive measure against accidental permanent wiping of a database.

Classes

AbstractTransactionalDataSourceSpringContextTests

Class Overview

See Also

Summary

Fields

protected JdbcTemplate jdbcTemplate

Public Constructors

public AbstractTransactionalDataSourceSpringContextTests ()

public AbstractTransactionalDataSourceSpringContextTests (String name)

Public Methods

public final JdbcTemplate getJdbcTemplate ()

public void setDataSource (DataSource dataSource)

public void setSqlScriptEncoding (String sqlScriptEncoding)

See Also

Protected Methods

protected int countRowsInTable (String tableName)

Parameters

Returns

protected void deleteFromTables (String[] names)

See Also

protected void executeSqlScript (String sqlResourcePath, boolean continueOnError)

Parameters

Throws

protected final void setComplete ()

See Also