程序包 cn.taketoday.test.context.junit4

类 AbstractTransactionalJUnit4ContextTests

java.lang.Object

cn.taketoday.test.context.junit4.AbstractJUnit4ContextTests

cn.taketoday.test.context.junit4.AbstractTransactionalJUnit4ContextTests

所有已实现的接口:

cn.taketoday.beans.factory.Aware, cn.taketoday.context.ApplicationContextAware

@TestExecutionListeners(listeners={ServletTestExecutionListener.class,DirtiesContextBeforeModesTestExecutionListener.class,ApplicationEventsTestExecutionListener.class,DependencyInjectionTestExecutionListener.class,DirtiesContextTestExecutionListener.class,TransactionalTestExecutionListener.class,SqlScriptsTestExecutionListener.class,EventPublishingTestExecutionListener.class},
                        inheritListeners=false)
@Transactional
public abstract class AbstractTransactionalJUnit4ContextTests
extends AbstractJUnit4ContextTests

Abstract transactional extension of AbstractJUnit4ContextTests which adds convenience functionality for JDBC access. Expects a DataSource bean and a PlatformTransactionManager bean to be defined in the Infra application context.

This class exposes a JdbcTemplate and provides an easy way to count the number of rows in a table (potentially with a WHERE clause), delete from tables, drop tables, and execute SQL scripts within a transaction.

Concrete subclasses must fulfill the same requirements outlined in AbstractJUnit4ContextTests.

This class serves only as a convenience for extension.

• If you do not wish for your test classes to be tied to a Infra-specific class hierarchy, you may configure your own custom test classes by using InfraRunner, @ContextConfiguration, @TestExecutionListeners, etc.
• If you wish to extend this class and use a runner other than the InfraRunner, you can use ApplicationClassRule and ApplicationMethodRule and specify your runner of choice via @RunWith(...).

NOTE: This class requires JUnit 4.12 or higher.

从以下版本开始:

4.0

作者:

Sam Brannen, Juergen Hoeller

另请参阅:

• AbstractJUnit4ContextTests
• ContextConfiguration
• TestExecutionListeners
• TransactionalTestExecutionListener
• SqlScriptsTestExecutionListener
• Transactional
• Commit
• Rollback
• BeforeTransaction
• AfterTransaction
• JdbcTestUtils

字段概要

字段

修饰符和类型	字段	说明
protected final cn.taketoday.jdbc.core.JdbcTemplate	jdbcTemplate	The JdbcTemplate that this base class manages, available to subclasses.
private String	sqlScriptEncoding

从类继承的字段 cn.taketoday.test.context.junit4.AbstractJUnit4ContextTests

applicationContext, logger

构造器概要

构造器

构造器	说明
AbstractTransactionalJUnit4ContextTests()

方法概要

修饰符和类型	方法	说明
protected int	countRowsInTable(String tableName)	Convenience method for counting the rows in the given table.
protected int	countRowsInTableWhere(String tableName, String whereClause)	Convenience method for counting the rows in the given table, using the provided WHERE clause.
protected int	deleteFromTables(String... names)	Convenience method for deleting all rows from the specified tables.
protected int	deleteFromTableWhere(String tableName, String whereClause, Object... args)	Convenience method for deleting all rows from the given table, using the provided WHERE clause.
protected void	dropTables(String... names)	Convenience method for dropping all of the specified tables.
protected void	executeSqlScript(String sqlResourcePath, boolean continueOnError)	Execute the given SQL script.
void	setDataSource(DataSource dataSource)	Set the DataSource, typically provided via Dependency Injection.
void	setSqlScriptEncoding(String sqlScriptEncoding)	Specify the encoding for SQL scripts, if different from the platform encoding.

从类继承的方法 cn.taketoday.test.context.junit4.AbstractJUnit4ContextTests

setApplicationContext

从类继承的方法 java.lang.Object

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

字段详细资料

jdbcTemplate

protected final cn.taketoday.jdbc.core.JdbcTemplate jdbcTemplate

The JdbcTemplate that this base class manages, available to subclasses.

从以下版本开始:

4.0

sqlScriptEncoding

@Nullable
private String sqlScriptEncoding

构造器详细资料

AbstractTransactionalJUnit4ContextTests

public AbstractTransactionalJUnit4ContextTests()

方法详细资料

setDataSource

public void setDataSource(DataSource dataSource)

Set the DataSource, typically provided via Dependency Injection.

This method also instantiates the jdbcTemplate instance variable.

setSqlScriptEncoding

public void setSqlScriptEncoding(String sqlScriptEncoding)

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

另请参阅:

• executeSqlScript(java.lang.String, boolean)

countRowsInTable

protected int countRowsInTable(String tableName)

Convenience method for counting the rows in the given table.

参数:

tableName - table name to count rows in

返回:

the number of rows in the table

另请参阅:

• JdbcTestUtils.countRowsInTable(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String)

countRowsInTableWhere

protected int countRowsInTableWhere(String tableName,
 String whereClause)

Convenience method for counting the rows in the given table, using the provided WHERE clause.

See the Javadoc for JdbcTestUtils.countRowsInTableWhere(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String, java.lang.String) for details.

参数:

tableName - the name of the table to count rows in

whereClause - the WHERE clause to append to the query

返回:

the number of rows in the table that match the provided WHERE clause

从以下版本开始:

4.0

另请参阅:

• JdbcTestUtils.countRowsInTableWhere(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String, java.lang.String)

deleteFromTables

protected int deleteFromTables(String... names)

Convenience method for deleting all rows from the specified tables.

Use with caution outside of a transaction!

参数:

names - the names of the tables from which to delete

返回:

the total number of rows deleted from all specified tables

另请参阅:

• JdbcTestUtils.deleteFromTables(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String...)

deleteFromTableWhere

protected int deleteFromTableWhere(String tableName,
 String whereClause,
 Object... args)

Convenience method for deleting all rows from the given table, using the provided WHERE clause.

Use with caution outside of a transaction!

See the Javadoc for JdbcTestUtils.deleteFromTableWhere(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String, java.lang.String, java.lang.Object...) for details.

参数:

tableName - the name of the table to delete rows from

whereClause - the WHERE clause to append to the query

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale.

返回:

the number of rows deleted from the table

从以下版本开始:

4.0

另请参阅:

• JdbcTestUtils.deleteFromTableWhere(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String, java.lang.String, java.lang.Object...)

dropTables

protected void dropTables(String... names)

Convenience method for dropping all of the specified tables.

Use with caution outside of a transaction!

参数:

names - the names of the tables to drop

从以下版本开始:

4.0

另请参阅:

• JdbcTestUtils.dropTables(cn.taketoday.jdbc.core.JdbcOperations, java.lang.String...)

executeSqlScript

protected void executeSqlScript(String sqlResourcePath,
 boolean continueOnError)
                         throws cn.taketoday.dao.DataAccessException

Execute the given SQL script.

Use with caution outside of a transaction!

The script will normally be loaded by classpath.

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

参数:

sqlResourcePath - the Infra resource path for the SQL script

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

抛出:

cn.taketoday.dao.DataAccessException - if there is an error executing a statement

另请参阅:

• ResourceDatabasePopulator
• setSqlScriptEncoding(java.lang.String)