Document effect of preemptive timeouts on transactional tests [SPR-17647]

[spring-projects-issues]

Sam Brannen opened SPR-17647 and commented

Overview

As discussed in JUnit 5 issue 1701, developers are often unaware of the effect that a preemptive timeout in a testing framework can have on transactional tests in Spring.

Documenting such use cases in the Testing chapter of the Spring Reference Manual, analogous to how I documented it in the JUnit 5 User Guide, would help improve awareness.

Deliverables

• Document effect of preemptive timeouts on transactional tests in the Testing chapter.
• Mention JUnit Jupiter's assertTimeoutPreemptively().
• Mention JUnit 4's Timeout rule and timeout support.
• Mention TestNG's timeOut support.

---

Reference URL: junit-team/junit5#1701

Issue Links:

• #10792 Support timed transactional TestNG tests in the TestContext framework

Referenced from: commits e1e6224, df13e4d

[spring-projects-issues]

Sam Brannen commented

This is closely related to #10792.

[spring-projects-issues]

Sam Brannen commented

This has been documented in the following commits.

• 5.2.x/master: df13e4d
• 5.1.x: e1e6224