Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Document suppressed exception support in TestContextManager

Browse Source 
Issue: SPR-14459
This commit is contained in:
Sam Brannen
2016-07-14 15:43:18 +02:00
parent e2b8a786ff
commit 3fa88c2b56
1 changed files with 20 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
spring-test/src/main/java/org/springframework/test/context/TestContextManager.java
View File

@@ -335,9 +335,11 @@ public class TestContextManager {
* {@code testInstance}, {@code testMethod}, and {@code exception}. * {@code testInstance}, {@code testMethod}, and {@code exception}.
* <p>Each registered {@link TestExecutionListener} will be given a chance * <p>Each registered {@link TestExecutionListener} will be given a chance
* to perform its post-processing. If a listener throws an exception, the * to perform its post-processing. If a listener throws an exception, the
* remaining registered listeners will still be called, but the first * remaining registered listeners will still be called. After all listeners
* exception thrown will be tracked and rethrown after all listeners have * have executed, the first caught exception will be rethrown with any
* executed. Note that registered listeners will be executed in the opposite * subsequent exceptions {@linkplain Throwable#addSuppressed suppressed} in
* the first exception.
* <p>Note that registered listeners will be executed in the opposite
* order in which they were registered. * order in which they were registered.
* @param testInstance the current test instance (never {@code null}) * @param testInstance the current test instance (never {@code null})
* @param testMethod the test method which has just been executed on the * @param testMethod the test method which has just been executed on the
@@ -351,6 +353,7 @@ public class TestContextManager {
* @see #afterTestMethod * @see #afterTestMethod
* @see #beforeTestExecution * @see #beforeTestExecution
* @see #getTestExecutionListeners() * @see #getTestExecutionListeners()
* @see Throwable#addSuppressed(Throwable)
*/ */
public void afterTestExecution(Object testInstance, Method testMethod, Throwable exception) throws Exception { public void afterTestExecution(Object testInstance, Method testMethod, Throwable exception) throws Exception {
String callbackName = "afterTestExecution"; String callbackName = "afterTestExecution";
@@ -394,10 +397,11 @@ public class TestContextManager {
* {@code testInstance}, {@code testMethod}, and {@code exception}. * {@code testInstance}, {@code testMethod}, and {@code exception}.
* <p>Each registered {@link TestExecutionListener} will be given a chance * <p>Each registered {@link TestExecutionListener} will be given a chance
* to perform its post-processing. If a listener throws an exception, the * to perform its post-processing. If a listener throws an exception, the
* remaining registered listeners will still be called, but the first * remaining registered listeners will still be called. After all listeners
* exception thrown will be tracked and rethrown after all listeners have * have executed, the first caught exception will be rethrown with any
* executed. Note that registered listeners will be executed in the opposite * subsequent exceptions {@linkplain Throwable#addSuppressed suppressed} in
* order in which they were registered. * the first exception.
* <p>Note that registered listeners will be executed in the opposite
* @param testInstance the current test instance (never {@code null}) * @param testInstance the current test instance (never {@code null})
* @param testMethod the test method which has just been executed on the * @param testMethod the test method which has just been executed on the
* test instance * test instance
@@ -409,6 +413,7 @@ public class TestContextManager {
* @see #beforeTestExecution * @see #beforeTestExecution
* @see #afterTestExecution * @see #afterTestExecution
* @see #getTestExecutionListeners() * @see #getTestExecutionListeners()
* @see Throwable#addSuppressed(Throwable)
*/ */
public void afterTestMethod(Object testInstance, Method testMethod, Throwable exception) throws Exception { public void afterTestMethod(Object testInstance, Method testMethod, Throwable exception) throws Exception {
String callbackName = "afterTestMethod"; String callbackName = "afterTestMethod";
@@ -441,15 +446,17 @@ public class TestContextManager {
* tests within the class. Should be called after any framework-specific * tests within the class. Should be called after any framework-specific
* <em>after class methods</em> (e.g., methods annotated with JUnit 4's * <em>after class methods</em> (e.g., methods annotated with JUnit 4's
* {@link org.junit.AfterClass @AfterClass}). * {@link org.junit.AfterClass @AfterClass}).
* <p>Each registered {@link TestExecutionListener} will be given a chance to * <p>Each registered {@link TestExecutionListener} will be given a chance
* post-process the test class. If a listener throws an exception, the * to perform its post-processing. If a listener throws an exception, the
* remaining registered listeners will still be called, but the first * remaining registered listeners will still be called. After all listeners
* exception thrown will be tracked and rethrown after all listeners have * have executed, the first caught exception will be rethrown with any
* executed. Note that registered listeners will be executed in the opposite * subsequent exceptions {@linkplain Throwable#addSuppressed suppressed} in
* order in which they were registered. * the first exception.
* <p>Note that registered listeners will be executed in the opposite
* @throws Exception if a registered TestExecutionListener throws an exception * @throws Exception if a registered TestExecutionListener throws an exception
* @since 3.0 * @since 3.0
* @see #getTestExecutionListeners() * @see #getTestExecutionListeners()
* @see Throwable#addSuppressed(Throwable)
*/ */
public void afterTestClass() throws Exception { public void afterTestClass() throws Exception {
Class<?> testClass = getTestContext().getTestClass(); Class<?> testClass = getTestContext().getTestClass();