Package org.springframework.test.context.jdbc

Class SqlScriptsTestExecutionListener

java.lang.Object

org.springframework.test.context.support.AbstractTestExecutionListener

org.springframework.test.context.jdbc.SqlScriptsTestExecutionListener

All Implemented Interfaces:

org.springframework.core.Ordered, AotTestExecutionListener, TestExecutionListener

public class SqlScriptsTestExecutionListener
extends AbstractTestExecutionListener
implements AotTestExecutionListener

TestExecutionListener that provides support for executing SQL scripts and inlined statements configured via the @Sql annotation.

Scripts and inlined statements will be executed before or after execution of the corresponding test method, depending on the configured value of the executionPhase flag.

Scripts and inlined statements will be executed without a transaction, within an existing Spring-managed transaction, or within an isolated transaction, depending on the configured value of SqlConfig.transactionMode() and the presence of a transaction manager.

Script Resources

For details on default script detection and how script resource locations are interpreted, see Sql.scripts().

Required Spring Beans

A PlatformTransactionManager and a DataSource, just a PlatformTransactionManager, or just a DataSource must be defined as beans in the Spring ApplicationContext for the corresponding test. Consult the javadocs for SqlConfig.transactionMode(), SqlConfig.transactionManager(), SqlConfig.dataSource(), TestContextTransactionUtils.retrieveDataSource(org.springframework.test.context.TestContext, java.lang.String), and TestContextTransactionUtils.retrieveTransactionManager(org.springframework.test.context.TestContext, java.lang.String) for details on permissible configuration constellations and on the algorithms used to locate these beans.

Required Dependencies

Use of this listener requires the spring-jdbc and spring-tx modules as well as their transitive dependencies to be present on the classpath.

Since:

4.1

Author:

Sam Brannen, Dmitry Semukhin

See Also:

• Sql
• SqlConfig
• SqlMergeMode
• SqlGroup
• TestContextTransactionUtils
• TransactionalTestExecutionListener
• ResourceDatabasePopulator
• ScriptUtils

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
SqlScriptsTestExecutionListener()

Method Summary

Modifier and Type	Method	Description
void	afterTestMethod(TestContext testContext)	Execute SQL scripts configured via @Sql for the supplied TestContext after the current test method.
void	beforeTestMethod(TestContext testContext)	Execute SQL scripts configured via @Sql for the supplied TestContext before the current test method.
final int	getOrder()	Returns 5000.
void	processAheadOfTime(org.springframework.aot.hint.RuntimeHints runtimeHints, Class<?> testClass, ClassLoader classLoader)	Process the supplied test class and its methods and register run-time hints for any SQL scripts configured or detected as classpath resources via @Sql.

Methods inherited from class org.springframework.test.context.support.AbstractTestExecutionListener

afterTestClass, afterTestExecution, beforeTestClass, beforeTestExecution, prepareTestInstance

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.test.context.TestExecutionListener

afterTestClass, afterTestExecution, beforeTestClass, beforeTestExecution, prepareTestInstance

Constructor Details

SqlScriptsTestExecutionListener

public SqlScriptsTestExecutionListener()

Method Details

getOrder

public final int getOrder()

Returns 5000.

Specified by:

getOrder in interface org.springframework.core.Ordered

Overrides:

getOrder in class AbstractTestExecutionListener

beforeTestMethod

public void beforeTestMethod(TestContext testContext)

Execute SQL scripts configured via @Sql for the supplied TestContext before the current test method.

Specified by:

beforeTestMethod in interface TestExecutionListener

Overrides:

beforeTestMethod in class AbstractTestExecutionListener

Parameters:

testContext - the test context in which the test method will be executed; never null

See Also:

• TestExecutionListener.afterTestMethod(org.springframework.test.context.TestContext)
• TestExecutionListener.beforeTestExecution(org.springframework.test.context.TestContext)
• TestExecutionListener.afterTestExecution(org.springframework.test.context.TestContext)

afterTestMethod

public void afterTestMethod(TestContext testContext)

Execute SQL scripts configured via @Sql for the supplied TestContext after the current test method.

Specified by:

afterTestMethod in interface TestExecutionListener

Overrides:

afterTestMethod in class AbstractTestExecutionListener

Parameters:

testContext - the test context in which the test method was executed; never null

See Also:

• TestExecutionListener.beforeTestMethod(org.springframework.test.context.TestContext)
• TestExecutionListener.beforeTestExecution(org.springframework.test.context.TestContext)
• TestExecutionListener.afterTestExecution(org.springframework.test.context.TestContext)

processAheadOfTime

public void processAheadOfTime(org.springframework.aot.hint.RuntimeHints runtimeHints,
 Class<?> testClass,
 ClassLoader classLoader)

Process the supplied test class and its methods and register run-time hints for any SQL scripts configured or detected as classpath resources via @Sql.

Specified by:

processAheadOfTime in interface AotTestExecutionListener

Parameters:

runtimeHints - the RuntimeHints to use

testClass - the test class to process

classLoader - the classloader to use

Since:

6.0