类 TestContextManager

构造器详细资料

• 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<org.springframework.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.

• 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 (e.g., methods annotated with JUnit 4's @BeforeClass).

  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

  从以下版本开始:

  3.0

  另请参阅:

  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 for injecting dependencies, etc. Should be called immediately after instantiation of the test instance.

  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 (never null)

  抛出:

  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 (e.g., methods annotated with JUnit 4's @Before). 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 (never null)

  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 (e.g., methods annotated with JUnit 4's @Before).

  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 (never null)

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

  抛出:

  Exception - if a registered TestExecutionListener throws an exception

  从以下版本开始:

  5.0

  另请参阅:

  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 (e.g., methods annotated with JUnit 4's @After).

  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 (never null)

  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

  从以下版本开始:

  5.0

  另请参阅:

  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 (e.g., methods annotated with JUnit 4's @After). 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 (never null)

  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 (e.g., methods annotated with JUnit 4's @AfterClass).

  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

  从以下版本开始:

  3.0

  另请参阅:

  getTestExecutionListeners(), Throwable.addSuppressed(Throwable)