Package org.junit.jupiter.api.extension

Interface TestInstanceFactory

All Superinterfaces:

Extension

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
@API(status=EXPERIMENTAL,
     since="5.3")
public interface TestInstanceFactory
extends Extension

TestInstanceFactory defines the API for Extensions that wish to create test instances.

Common use cases include creating test instances with special construction requirements or acquiring the test instance from a dependency injection framework.

Only one TestInstanceFactory is allowed to be registered for each test class in the test class hierarchy, with lower level factories overriding factories registered at higher levels in the hierarchy. Registering multiple factories for any single test class will result in an exception being thrown for all the tests in that test class and any nested test classes.

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

Constructor Requirements

Consult the documentation in Extension for details on constructor requirements.

Since:

5.3

See Also:

createTestInstance(TestInstanceFactoryContext, ExtensionContext), TestInstanceFactoryContext, TestInstancePostProcessor, ParameterResolver

Method Summary

Modifier and Type	Method	Description
java.lang.Object	createTestInstance(TestInstanceFactoryContext factoryContext, ExtensionContext extensionContext)	Callback for creating a test instance for the supplied context.

Method Detail

createTestInstance

java.lang.Object createTestInstance(TestInstanceFactoryContext factoryContext,
                                    ExtensionContext extensionContext)
                             throws TestInstantiationException

Callback for creating a test instance for the supplied context.

Note: the ExtensionContext supplied to a TestInstanceFactory will always return an empty Optional value from getTestInstance() since the test instance cannot exist before it has been created by a TestInstanceFactory or the framework itself.

Parameters:

factoryContext - the context for the test class to be instantiated; never null

extensionContext - the current extension context; never null

Returns:

the test instance; never null

Throws:

TestInstantiationException - if an error occurs while creating the test instance