- All Superinterfaces:
- 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
TestInstanceFactorydefines the API for
Extensionsthat 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.
Extensions that implement
TestInstanceFactorymust be registered at the class level.
TestInstanceFactoryis allowed to be registered for any given test class. Registering multiple factories for any single test class will result in an exception being thrown for all tests in that class, in any subclass, and in any nested class. Note that any
TestInstanceFactoryregistered in a superclass or enclosing class (i.e., in the case of a
@Nestedtest class) is inherited. It is therefore the user's responsibility to ensure that only a single
TestInstanceFactoryis registered for any specific test class.
Consult the documentation in
Extensionfor details on constructor requirements.
Object createTestInstance(TestInstanceFactoryContext factoryContext, ExtensionContext extensionContext) throws TestInstantiationExceptionCallback for creating a test instance for the supplied context.
ExtensionContextsupplied to a
TestInstanceFactorywill always return an empty
getTestInstance()since the test instance cannot exist before it has been created by a
TestInstanceFactoryor the framework itself.
factoryContext- the context for the test class to be instantiated; never
extensionContext- the current extension context; never
- the test instance; never
TestInstantiationException- if an error occurs while creating the test instance