Interface TestInstancePostProcessor

  • All Superinterfaces:
    Extension


    @API(status=STABLE,
         since="5.0")
    public interface TestInstancePostProcessor
    extends Extension
    TestInstancePostProcessor defines the API for Extensions that wish to post-process test instances.

    Common use cases include injecting dependencies into the test instance, invoking custom initialization methods on the test instance, etc.

    Implementations must provide a no-args constructor.

    Extensions that implement TestInstancePostProcessor must be registered at the class level.

    Since:
    5.0
    See Also:
    postProcessTestInstance(Object, ExtensionContext)
    • Method Detail

      • postProcessTestInstance

        void postProcessTestInstance​(java.lang.Object testInstance,
                                     ExtensionContext context)
                              throws java.lang.Exception
        Callback for post-processing the supplied test instance.

        Note: the ExtensionContext supplied to a TestInstancePostProcessor will always return an empty Optional value from getTestInstance(). A TestInstancePostProcessor should therefore only attempt to process the supplied testInstance.

        Parameters:
        testInstance - the instance to post-process; never null
        context - the current extension context; never null
        Throws:
        java.lang.Exception