org.junit.jupiter.engine.extension

Class RepetitionExtension

java.lang.Object

org.junit.jupiter.engine.extension.RepetitionExtension

All Implemented Interfaces:

ExecutionCondition, Extension, ParameterResolver, TestWatcher

class RepetitionExtension
extends java.lang.Object
implements ParameterResolver, TestWatcher, ExecutionCondition

RepetitionExtension implements the following extension APIs to support repetitions of a @RepeatedTest method.

• ParameterResolver to resolve RepetitionInfo arguments
• TestWatcher to track the failure count
• ExecutionCondition to disable the repetition if the failure threshold has been exceeded

Since:

5.0

Field Summary

Fields

Modifier and Type	Field and Description
private DefaultRepetitionInfo	repetitionInfo

Constructor Summary

Constructors

Constructor and Description
RepetitionExtension(DefaultRepetitionInfo repetitionInfo)

Method Summary

Modifier and Type	Method and Description
ConditionEvaluationResult	evaluateExecutionCondition(ExtensionContext context) Evaluate this condition for the supplied ExtensionContext.
RepetitionInfo	resolveParameter(ParameterContext parameterContext, ExtensionContext extensionContext) Resolve an argument for the Parameter in the supplied ParameterContext for the supplied ExtensionContext.
boolean	supportsParameter(ParameterContext parameterContext, ExtensionContext extensionContext) Determine if this resolver supports resolution of an argument for the Parameter in the supplied ParameterContext for the supplied ExtensionContext.
void	testFailed(ExtensionContext context, java.lang.Throwable cause) Invoked after a test has failed.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.junit.jupiter.api.extension.TestWatcher

testAborted, testDisabled, testSuccessful

Field Detail

repetitionInfo

private final DefaultRepetitionInfo repetitionInfo

Constructor Detail

RepetitionExtension

RepetitionExtension(DefaultRepetitionInfo repetitionInfo)

Method Detail

supportsParameter

public boolean supportsParameter(ParameterContext parameterContext,
                                 ExtensionContext extensionContext)

Description copied from interface: ParameterResolver

Determine if this resolver supports resolution of an argument for the Parameter in the supplied ParameterContext for the supplied ExtensionContext.

The Method or Constructor in which the parameter is declared can be retrieved via ParameterContext.getDeclaringExecutable().

Specified by:

supportsParameter in interface ParameterResolver

Parameters:

parameterContext - the context for the parameter for which an argument should be resolved; never null

extensionContext - the extension context for the Executable about to be invoked; never null

Returns:

true if this resolver can resolve an argument for the parameter

See Also:

ParameterResolver.resolveParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext), ParameterContext

resolveParameter

public RepetitionInfo resolveParameter(ParameterContext parameterContext,
                                       ExtensionContext extensionContext)

Description copied from interface: ParameterResolver

Resolve an argument for the Parameter in the supplied ParameterContext for the supplied ExtensionContext.

This method is only called by the framework if ParameterResolver.supportsParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext) previously returned true for the same ParameterContext and ExtensionContext.

The Method or Constructor in which the parameter is declared can be retrieved via ParameterContext.getDeclaringExecutable().

Specified by:

resolveParameter in interface ParameterResolver

Parameters:

parameterContext - the context for the parameter for which an argument should be resolved; never null

extensionContext - the extension context for the Executable about to be invoked; never null

Returns:

the resolved argument for the parameter; may only be null if the parameter type is not a primitive

See Also:

ParameterResolver.supportsParameter(org.junit.jupiter.api.extension.ParameterContext, org.junit.jupiter.api.extension.ExtensionContext), ParameterContext

testFailed

public void testFailed(ExtensionContext context,
                       java.lang.Throwable cause)

Description copied from interface: TestWatcher

Invoked after a test has failed.

The default implementation does nothing. Concrete implementations can override this method as appropriate.

Specified by:

testFailed in interface TestWatcher

Parameters:

context - the current extension context; never null

cause - the throwable that caused test failure; may be null

evaluateExecutionCondition

public ConditionEvaluationResult evaluateExecutionCondition(ExtensionContext context)

Description copied from interface: ExecutionCondition

Evaluate this condition for the supplied ExtensionContext.

An enabled result indicates that the container or test should be executed; whereas, a disabled result indicates that the container or test should not be executed.

Specified by:

evaluateExecutionCondition in interface ExecutionCondition

Parameters:

context - the current extension context; never null

Returns:

the result of evaluating this condition; never null