Package org.junit.jupiter.api.extension

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 Summary

Modifier and Type	Method	Description
void	postProcessTestInstance(java.lang.Object testInstance, ExtensionContext context)	Callback for post-processing the supplied test instance.

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