程序包 cn.taketoday.test.context

类 TestContextManager

java.lang.Object

cn.taketoday.test.context.TestContextManager

public class TestContextManager
extends Object

TestContextManager is the main entry point into the Infra TestContext Framework.

Specifically, a TestContextManager is responsible for managing a single TestContext and signaling events to each registered TestExecutionListener at the following test execution points.

• before test class execution: prior to any before class callbacks of a particular testing framework (e.g., JUnit 4's @BeforeClass)
• test instance preparation: immediately following instantiation of the test class
• before test setup: prior to any before method callbacks of a particular testing framework (e.g., JUnit 4's @Before)
• before test execution: immediately before execution of the test method but after test setup
• after test execution: immediately after execution of the test method but before test tear down
• after test tear down: after any after method callbacks of a particular testing framework (e.g., JUnit 4's @After)
• after test class execution: after any after class callbacks of a particular testing framework (e.g., JUnit 4's @AfterClass)

Support for loading and accessing application contexts, dependency injection of test instances, transactional execution of test methods, etc. is provided by ContextLoaders and TestExecutionListeners, which are configured via @ContextConfiguration and @TestExecutionListeners, respectively.

Bootstrapping of the TestContext, the default ContextLoader, default TestExecutionListeners, and their collaborators is performed by a TestContextBootstrapper, which is configured via @BootstrapWith.

从以下版本开始:

4.0

作者:

Sam Brannen, Juergen Hoeller, Harry Yang

另请参阅:

• BootstrapWith
• BootstrapContext
• TestContextBootstrapper
• TestContext
• TestExecutionListener
• TestExecutionListeners
• ContextConfiguration
• ContextHierarchy

字段概要

字段

修饰符和类型	字段	说明
private static final cn.taketoday.logging.Logger	log
private static final Set<Class<? extends Throwable>>	skippedExceptionTypes
private final TestContext	testContext
private final ThreadLocal<TestContext>	testContextHolder
private final List<TestExecutionListener>	testExecutionListeners

构造器概要

构造器

构造器	说明
TestContextManager(TestContextBootstrapper testContextBootstrapper)	Construct a new TestContextManager using the supplied TestContextBootstrapper and register the necessary TestExecutionListeners.
TestContextManager(Class<?> testClass)	Construct a new TestContextManager for the supplied test class.

方法概要

修饰符和类型	方法	说明
void	afterTestClass()	Hook for post-processing a test class after execution of all tests within the class.
void	afterTestExecution(Object testInstance, Method testMethod, Throwable exception)	Hook for post-processing a test immediately after execution of the test method in the supplied test context — for example, for timing or logging purposes.
void	afterTestMethod(Object testInstance, Method testMethod, Throwable exception)	Hook for post-processing a test after execution of after lifecycle callbacks of the underlying test framework — for example, tearing down test fixtures, ending a transaction, etc.
void	beforeTestClass()	Hook for pre-processing a test class before execution of any tests within the class.
void	beforeTestExecution(Object testInstance, Method testMethod)	Hook for pre-processing a test immediately before execution of the test method in the supplied test context — for example, for timing or logging purposes.
void	beforeTestMethod(Object testInstance, Method testMethod)	Hook for pre-processing a test before execution of before lifecycle callbacks of the underlying test framework — for example, setting up test fixtures, starting a transaction, etc.
private static TestContext	copyTestContext(TestContext testContext)	Attempt to create a copy of the supplied TestContext using its copy constructor.
private List<TestExecutionListener>	getReversedTestExecutionListeners()	Get a copy of the TestExecutionListeners registered for this TestContextManager in reverse order.
final TestContext	getTestContext()	Get the TestContext managed by this TestContextManager.
final List<TestExecutionListener>	getTestExecutionListeners()	Get the current TestExecutionListeners registered for this TestContextManager.
private void	handleBeforeException(Throwable ex, String callbackName, TestExecutionListener testExecutionListener, Object testInstance, Method testMethod)
private static boolean	isSkippedException(Throwable ex)
private void	logException(Throwable ex, String callbackName, TestExecutionListener testExecutionListener, Class<?> testClass)
private void	logException(Throwable ex, String callbackName, TestExecutionListener testExecutionListener, Object testInstance, Method testMethod)
private void	prepareForAfterCallback(String callbackName, Object testInstance, Method testMethod, Throwable exception)
private void	prepareForBeforeCallback(String callbackName, Object testInstance, Method testMethod)
void	prepareTestInstance(Object testInstance)	Hook for preparing a test instance prior to execution of any individual test methods — for example, to inject dependencies.
private static void	registerSkippedExceptionType(String name)
void	registerTestExecutionListeners(TestExecutionListener... testExecutionListeners)	Register the supplied array of TestExecutionListeners by appending them to the list of listeners used by this TestContextManager.
void	registerTestExecutionListeners(List<TestExecutionListener> testExecutionListeners)	Register the supplied list of TestExecutionListeners by appending them to the list of listeners used by this TestContextManager.
private static String	typeName(Object obj)

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

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

字段详细资料

log

private static final cn.taketoday.logging.Logger log

skippedExceptionTypes

private static final Set<Class<? extends Throwable>> skippedExceptionTypes

testContext

private final TestContext testContext

testContextHolder

private final ThreadLocal<TestContext> testContextHolder

testExecutionListeners

private final List<TestExecutionListener> testExecutionListeners

构造器详细资料

TestContextManager

public TestContextManager(Class<?> testClass)

Construct a new TestContextManager for the supplied test class.

Delegates to TestContextManager(TestContextBootstrapper) with the TestContextBootstrapper configured for the test class. If the @BootstrapWith annotation is present on the test class, either directly or as a meta-annotation, then its value will be used as the bootstrapper type; otherwise, the DefaultTestContextBootstrapper will be used.

参数:

testClass - the test class to be managed

另请参阅:

• TestContextManager(TestContextBootstrapper)

TestContextManager

public TestContextManager(TestContextBootstrapper testContextBootstrapper)

Construct a new TestContextManager using the supplied TestContextBootstrapper and register the necessary TestExecutionListeners.

Delegates to the supplied TestContextBootstrapper for building the TestContext and retrieving the TestExecutionListeners.

参数:

testContextBootstrapper - the bootstrapper to use

另请参阅:

• TestContextBootstrapper.buildTestContext()
• TestContextBootstrapper.getTestExecutionListeners()
• registerTestExecutionListeners(java.util.List<cn.taketoday.test.context.TestExecutionListener>)

方法详细资料

getTestContext

public final TestContext getTestContext()

Get the TestContext managed by this TestContextManager.

registerTestExecutionListeners

public void registerTestExecutionListeners(List<TestExecutionListener> testExecutionListeners)

Register the supplied list of TestExecutionListeners by appending them to the list of listeners used by this TestContextManager.

另请参阅:

• registerTestExecutionListeners(TestExecutionListener...)

registerTestExecutionListeners

public void registerTestExecutionListeners(TestExecutionListener... testExecutionListeners)

Register the supplied array of TestExecutionListeners by appending them to the list of listeners used by this TestContextManager.

getTestExecutionListeners

public final List<TestExecutionListener> getTestExecutionListeners()

Get the current TestExecutionListeners registered for this TestContextManager.

Allows for modifications, e.g. adding a listener to the beginning of the list. However, make sure to keep the list stable while actually executing tests.

getReversedTestExecutionListeners

private List<TestExecutionListener> getReversedTestExecutionListeners()

Get a copy of the TestExecutionListeners registered for this TestContextManager in reverse order.

beforeTestClass

public void beforeTestClass()
                     throws Exception

Hook for pre-processing a test class before execution of any tests within the class. Should be called prior to any framework-specific before class methods — for example, methods annotated with JUnit Jupiter's @BeforeAll.

An attempt will be made to give each registered TestExecutionListener a chance to pre-process the test class execution. If a listener throws an exception, however, the remaining registered listeners will not be called.

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• getTestExecutionListeners()

prepareTestInstance

public void prepareTestInstance(Object testInstance)
                         throws Exception

Hook for preparing a test instance prior to execution of any individual test methods — for example, to inject dependencies.

This method should be called immediately after instantiation of the test class or as soon after instantiation as possible (as is the case with the InfraMethodRule). In any case, this method must be called prior to any framework-specific lifecycle callbacks.

The managed TestContext will be updated with the supplied testInstance.

An attempt will be made to give each registered TestExecutionListener a chance to prepare the test instance. If a listener throws an exception, however, the remaining registered listeners will not be called.

参数:

testInstance - the test instance to prepare

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• getTestExecutionListeners()

beforeTestMethod

public void beforeTestMethod(Object testInstance,
 Method testMethod)
                      throws Exception

Hook for pre-processing a test before execution of before lifecycle callbacks of the underlying test framework — for example, setting up test fixtures, starting a transaction, etc.

This method must be called immediately prior to framework-specific before lifecycle callbacks — for example, methods annotated with JUnit Jupiter's @BeforeEach. For historical reasons, this method is named beforeTestMethod. Since the introduction of beforeTestExecution(java.lang.Object, java.lang.reflect.Method), a more suitable name for this method might be something like beforeTestSetUp or beforeEach; however, it is unfortunately impossible to rename this method due to backward compatibility concerns.

The managed TestContext will be updated with the supplied testInstance and testMethod.

An attempt will be made to give each registered TestExecutionListener a chance to perform its pre-processing. If a listener throws an exception, however, the remaining registered listeners will not be called.

参数:

testInstance - the current test instance

testMethod - the test method which is about to be executed on the test instance

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• beforeTestExecution(java.lang.Object, java.lang.reflect.Method)
• afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• getTestExecutionListeners()

beforeTestExecution

public void beforeTestExecution(Object testInstance,
 Method testMethod)
                         throws Exception

Hook for pre-processing a test immediately before execution of the test method in the supplied test context — for example, for timing or logging purposes.

This method must be called after framework-specific before lifecycle callbacks — for example, methods annotated with JUnit Jupiter's @BeforeEach.

The managed TestContext will be updated with the supplied testInstance and testMethod.

An attempt will be made to give each registered TestExecutionListener a chance to perform its pre-processing. If a listener throws an exception, however, the remaining registered listeners will not be called.

参数:

testInstance - the current test instance

testMethod - the test method which is about to be executed on the test instance

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• beforeTestMethod(java.lang.Object, java.lang.reflect.Method)
• afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• beforeTestExecution(java.lang.Object, java.lang.reflect.Method)
• afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• getTestExecutionListeners()

afterTestExecution

public void afterTestExecution(Object testInstance,
 Method testMethod,
 @Nullable
 Throwable exception)
                        throws Exception

Hook for post-processing a test immediately after execution of the test method in the supplied test context — for example, for timing or logging purposes.

This method must be called before framework-specific after lifecycle callbacks — for example, methods annotated with JUnit Jupiter's @AfterEach.

The managed TestContext will be updated with the supplied testInstance, testMethod, and exception.

Each registered TestExecutionListener will be given a chance to perform its post-processing. If a listener throws an exception, the remaining registered listeners will still be called. After all listeners have executed, the first caught exception will be rethrown with any subsequent exceptions suppressed in the first exception.

Note that registered listeners will be executed in the opposite order in which they were registered.

参数:

testInstance - the current test instance

testMethod - the test method which has just been executed on the test instance

exception - the exception that was thrown during execution of the test method or by a TestExecutionListener, or null if none was thrown

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• beforeTestMethod(java.lang.Object, java.lang.reflect.Method)
• afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• beforeTestExecution(java.lang.Object, java.lang.reflect.Method)
• getTestExecutionListeners()
• Throwable.addSuppressed(Throwable)

afterTestMethod

public void afterTestMethod(Object testInstance,
 Method testMethod,
 @Nullable
 Throwable exception)
                     throws Exception

Hook for post-processing a test after execution of after lifecycle callbacks of the underlying test framework — for example, tearing down test fixtures, ending a transaction, etc.

This method must be called immediately after framework-specific after lifecycle callbacks — for example, methods annotated with JUnit Jupiter's @AfterEach. For historical reasons, this method is named afterTestMethod. Since the introduction of afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), a more suitable name for this method might be something like afterTestTearDown or afterEach; however, it is unfortunately impossible to rename this method due to backward compatibility concerns.

The managed TestContext will be updated with the supplied testInstance, testMethod, and exception.

Each registered TestExecutionListener will be given a chance to perform its post-processing. If a listener throws an exception, the remaining registered listeners will still be called. After all listeners have executed, the first caught exception will be rethrown with any subsequent exceptions suppressed in the first exception.

Note that registered listeners will be executed in the opposite

参数:

testInstance - the current test instance

testMethod - the test method which has just been executed on the test instance

exception - the exception that was thrown during execution of the test method or by a TestExecutionListener, or null if none was thrown

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• beforeTestMethod(java.lang.Object, java.lang.reflect.Method)
• beforeTestExecution(java.lang.Object, java.lang.reflect.Method)
• afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable)
• getTestExecutionListeners()
• Throwable.addSuppressed(Throwable)

afterTestClass

public void afterTestClass()
                    throws Exception

Hook for post-processing a test class after execution of all tests within the class. Should be called after any framework-specific after class methods — for example, methods annotated with JUnit Jupiter's @AfterAll.

Each registered TestExecutionListener will be given a chance to perform its post-processing. If a listener throws an exception, the remaining registered listeners will still be called. After all listeners have executed, the first caught exception will be rethrown with any subsequent exceptions suppressed in the first exception.

Note that registered listeners will be executed in the opposite

抛出:

Exception - if a registered TestExecutionListener throws an exception

另请参阅:

• getTestExecutionListeners()
• Throwable.addSuppressed(Throwable)

prepareForBeforeCallback

private void prepareForBeforeCallback(String callbackName,
 Object testInstance,
 Method testMethod)

prepareForAfterCallback

private void prepareForAfterCallback(String callbackName,
 Object testInstance,
 Method testMethod,
 @Nullable
 Throwable exception)

handleBeforeException

private void handleBeforeException(Throwable ex,
 String callbackName,
 TestExecutionListener testExecutionListener,
 Object testInstance,
 Method testMethod)
                            throws Exception

抛出:

Exception

logException

private void logException(Throwable ex,
 String callbackName,
 TestExecutionListener testExecutionListener,
 Class<?> testClass)

logException

private void logException(Throwable ex,
 String callbackName,
 TestExecutionListener testExecutionListener,
 Object testInstance,
 Method testMethod)

copyTestContext

private static TestContext copyTestContext(TestContext testContext)

Attempt to create a copy of the supplied TestContext using its copy constructor.

typeName

private static String typeName(@Nullable
 Object obj)

registerSkippedExceptionType

private static void registerSkippedExceptionType(String name)

isSkippedException

private static boolean isSkippedException(Throwable ex)