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

类 TransactionalTestExecutionListener

java.lang.Object
cn.taketoday.test.context.support.AbstractTestExecutionListener
cn.taketoday.test.context.transaction.TransactionalTestExecutionListener
所有已实现的接口:
cn.taketoday.core.Ordered, TestExecutionListener
public class TransactionalTestExecutionListener extends AbstractTestExecutionListener
TestExecutionListener that provides support for executing tests within test-managed transactions by honoring Framework's @Transactional annotation.

Test-managed Transactions

Test-managed transactions are transactions that are managed declaratively via this listener or programmatically via TestTransaction. Such transactions should not be confused with Infra-managed transactions (i.e., those managed directly by Infra within the ApplicationContext loaded for tests) or application-managed transactions (i.e., those managed programmatically within application code that is invoked via tests). Infra-managed and application-managed transactions will typically participate in test-managed transactions; however, caution should be taken if Infra-managed or application-managed transactions are configured with any propagation type other than REQUIRED or SUPPORTS.

Enabling and Disabling Transactions

Annotating a test method with @Transactional causes the test to be run within a transaction that will, by default, be automatically rolled back after completion of the test. If a test class is annotated with @Transactional, each test method within that class hierarchy will be run within a transaction. Test methods that are not annotated with @Transactional (at the class or method level) will not be run within a transaction. Furthermore, tests that are annotated with @Transactional but have the propagation type set to NOT_SUPPORTED or NEVER will not be run within a transaction.

Declarative Rollback and Commit Behavior

By default, test transactions will be automatically rolled back after completion of the test; however, transactional commit and rollback behavior can be configured declaratively via the @Commit and @Rollback annotations at the class level and at the method level.

Programmatic Transaction Management

it is possible to interact with test-managed transactions programmatically via the static methods in TestTransaction. TestTransaction may be used within test methods, before methods, and after methods.

Executing Code outside of a Transaction

When executing transactional tests, it is sometimes useful to be able to execute certain set up or tear down code outside of a transaction. TransactionalTestExecutionListener provides such support for methods annotated with @BeforeTransaction or @AfterTransaction. @BeforeTransaction and @AfterTransaction may also be declared on Java 8 based interface default methods.

Configuring a Transaction Manager

TransactionalTestExecutionListener expects a PlatformTransactionManager bean to be defined in the Infra ApplicationContext for the test. In case there are multiple instances of PlatformTransactionManager within the test's ApplicationContext, a qualifier may be declared via @Transactional (e.g., @Transactional("myTxMgr") or @Transactional(transactionManager = "myTxMgr"), or TransactionManagementConfigurer can be implemented by an @Configuration class. See TestContextTransactionUtils.retrieveTransactionManager(cn.taketoday.test.context.TestContext, java.lang.String) for details on the algorithm used to look up a transaction manager in the test's ApplicationContext.

@Transactional Attribute Support

AttributeSupported for test-managed transactions
value and transactionManageryes
propagation only NOT_SUPPORTED and NEVER are supported
isolationno
timeoutno
readOnlyno
rollbackFor and rollbackForClassName no: use TestTransaction.flagForRollback() instead
noRollbackFor and noRollbackForClassName no: use TestTransaction.flagForCommit() instead
从以下版本开始:
4.0
作者:
Sam Brannen, Juergen Hoeller
另请参阅:

  • 字段详细资料

    • logger

      private static final cn.taketoday.logging.Logger logger

    • attributeSource

      protected final cn.taketoday.transaction.interceptor.TransactionAttributeSource attributeSource

  • 构造器详细资料

    • TransactionalTestExecutionListener

      public TransactionalTestExecutionListener()

  • 方法详细资料