org.junit.jupiter.params

Class ParameterizedTestExtension

java.lang.Object

org.junit.jupiter.params.ParameterizedTestExtension

All Implemented Interfaces:

Extension, TestTemplateInvocationContextProvider

class ParameterizedTestExtension
extends java.lang.Object
implements TestTemplateInvocationContextProvider

Since:

5.0

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static java.lang.String	ARGUMENT_MAX_LENGTH_KEY
private static java.lang.String	DEFAULT_DISPLAY_NAME
(package private) static java.lang.String	DISPLAY_NAME_PATTERN_KEY
private static java.lang.String	METHOD_CONTEXT_KEY

Constructor Summary

Constructors

Constructor and Description
ParameterizedTestExtension()

Method Summary

Modifier and Type	Method and Description
protected static java.util.stream.Stream<? extends Arguments>	arguments(ArgumentsProvider provider, ExtensionContext context)
private java.lang.Object[]	consumedArguments(java.lang.Object[] arguments, ParameterizedTestMethodContext methodContext)
private TestTemplateInvocationContext	createInvocationContext(ParameterizedTestNameFormatter formatter, ParameterizedTestMethodContext methodContext, java.lang.Object[] arguments, int invocationIndex)
private ParameterizedTestNameFormatter	createNameFormatter(ExtensionContext extensionContext, java.lang.reflect.Method templateMethod, ParameterizedTestMethodContext methodContext, java.lang.String displayName, int argumentMaxLength)
private ExtensionContext.Store	getStore(ExtensionContext context)
private ArgumentsProvider	instantiateArgumentsProvider(java.lang.Class<? extends ArgumentsProvider> clazz)
java.util.stream.Stream<TestTemplateInvocationContext>	provideTestTemplateInvocationContexts(ExtensionContext extensionContext) Provide invocation contexts for the test template method represented by the supplied context.
boolean	supportsTestTemplate(ExtensionContext context) Determine if this provider supports providing invocation contexts for the test template method represented by the supplied context.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

METHOD_CONTEXT_KEY

private static final java.lang.String METHOD_CONTEXT_KEY

See Also:

Constant Field Values

ARGUMENT_MAX_LENGTH_KEY

static final java.lang.String ARGUMENT_MAX_LENGTH_KEY

See Also:

Constant Field Values

DEFAULT_DISPLAY_NAME

private static final java.lang.String DEFAULT_DISPLAY_NAME

See Also:

Constant Field Values

DISPLAY_NAME_PATTERN_KEY

static final java.lang.String DISPLAY_NAME_PATTERN_KEY

See Also:

Constant Field Values

Constructor Detail

ParameterizedTestExtension

ParameterizedTestExtension()

Method Detail

supportsTestTemplate

public boolean supportsTestTemplate(ExtensionContext context)

Description copied from interface: TestTemplateInvocationContextProvider

Determine if this provider supports providing invocation contexts for the test template method represented by the supplied context.

Specified by:

supportsTestTemplate in interface TestTemplateInvocationContextProvider

Parameters:

context - the extension context for the test template method about to be invoked; never null

Returns:

true if this provider can provide invocation contexts

See Also:

TestTemplateInvocationContextProvider.provideTestTemplateInvocationContexts(org.junit.jupiter.api.extension.ExtensionContext), ExtensionContext

provideTestTemplateInvocationContexts

public java.util.stream.Stream<TestTemplateInvocationContext> provideTestTemplateInvocationContexts(ExtensionContext extensionContext)

Description copied from interface: TestTemplateInvocationContextProvider

Provide invocation contexts for the test template method represented by the supplied context.

This method is only called by the framework if TestTemplateInvocationContextProvider.supportsTestTemplate(org.junit.jupiter.api.extension.ExtensionContext) previously returned true for the same ExtensionContext; this method is allowed to return an empty Stream but not null.

The returned Stream will be properly closed by calling BaseStream.close(), making it safe to use a resource such as Files.lines().

Specified by:

provideTestTemplateInvocationContexts in interface TestTemplateInvocationContextProvider

Parameters:

extensionContext - the extension context for the test template method about to be invoked; never null

Returns:

a Stream of TestTemplateInvocationContext instances for the invocation of the test template method; never null

See Also:

TestTemplateInvocationContextProvider.supportsTestTemplate(org.junit.jupiter.api.extension.ExtensionContext), ExtensionContext

instantiateArgumentsProvider

private ArgumentsProvider instantiateArgumentsProvider(java.lang.Class<? extends ArgumentsProvider> clazz)

getStore

private ExtensionContext.Store getStore(ExtensionContext context)

createInvocationContext

private TestTemplateInvocationContext createInvocationContext(ParameterizedTestNameFormatter formatter,
                                                              ParameterizedTestMethodContext methodContext,
                                                              java.lang.Object[] arguments,
                                                              int invocationIndex)

createNameFormatter

private ParameterizedTestNameFormatter createNameFormatter(ExtensionContext extensionContext,
                                                           java.lang.reflect.Method templateMethod,
                                                           ParameterizedTestMethodContext methodContext,
                                                           java.lang.String displayName,
                                                           int argumentMaxLength)

arguments

protected static java.util.stream.Stream<? extends Arguments> arguments(ArgumentsProvider provider,
                                                                        ExtensionContext context)

consumedArguments

private java.lang.Object[] consumedArguments(java.lang.Object[] arguments,
                                             ParameterizedTestMethodContext methodContext)