Module org.junit.jupiter.params

Package org.junit.jupiter.params.provider

Class AnnotationBasedArgumentsProvider<A extends Annotation>

java.lang.Object

org.junit.jupiter.params.provider.AnnotationBasedArgumentsProvider<A>

All Implemented Interfaces:

Consumer<A>, ArgumentsProvider, AnnotationConsumer<A>

@API(status=MAINTAINED,
     since="5.13.3")
public abstract class AnnotationBasedArgumentsProvider<A extends Annotation>
extends Object
implements ArgumentsProvider, AnnotationConsumer<A>

AnnotationBasedArgumentsProvider is an abstract base class for ArgumentsProvider implementations that also need to consume an annotation in order to provide the arguments.

Since:

5.10

See Also:

• ParameterizedClass
• ParameterizedTest
• ArgumentsSource
• Arguments
• ArgumentsProvider
• AnnotationConsumer

Constructor Summary

Constructors

Constructor	Description
AnnotationBasedArgumentsProvider()

Method Summary

Modifier and Type	Method	Description
final void	accept(A annotation)
protected Stream<? extends Arguments>	provideArguments(ExtensionContext context, A annotation)	Deprecated. Please implement provideArguments(ParameterDeclarations, ExtensionContext, Annotation) instead.
Stream<? extends Arguments>	provideArguments(ParameterDeclarations parameters, ExtensionContext context)	Provide a Stream of Arguments to be passed to a @ParameterizedClass or @ParameterizedTest.
protected Stream<? extends Arguments>	provideArguments(ParameterDeclarations parameters, ExtensionContext context, A annotation)	The returned Stream will be properly closed by the default implementation of provideArguments(ParameterDeclarations, ExtensionContext), making it safe to use a resource such as Files.lines().

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.params.provider.ArgumentsProvider

provideArguments

Methods inherited from interface java.util.function.Consumer

andThen

Constructor Details

AnnotationBasedArgumentsProvider

public AnnotationBasedArgumentsProvider()

Method Details

accept

public final void accept(A annotation)

Specified by:

accept in interface Consumer<A extends Annotation>

provideArguments

public Stream<? extends Arguments> provideArguments(ParameterDeclarations parameters,
 ExtensionContext context)

Description copied from interface: ArgumentsProvider

Provide a Stream of Arguments to be passed to a @ParameterizedClass or @ParameterizedTest.

Specified by:

provideArguments in interface ArgumentsProvider

Parameters:

parameters - the parameter declarations for the parameterized class or test; never null

context - the current extension context; never null

Returns:

a stream of arguments; never null

provideArguments

@Deprecated
@API(status=DEPRECATED,
     since="5.13")
protected Stream<? extends Arguments> provideArguments(ExtensionContext context,
 A annotation)

Deprecated.

Please implement provideArguments(ParameterDeclarations, ExtensionContext, Annotation) instead.

Provide a Stream of Arguments — based on metadata in the provided annotation — to be passed to a @ParameterizedTest method.

Parameters:

context - the current extension context; never null

annotation - the annotation to process; never null

Returns:

a stream of arguments; never null

provideArguments

protected Stream<? extends Arguments> provideArguments(ParameterDeclarations parameters,
 ExtensionContext context,
 A annotation)

The returned Stream will be properly closed by the default implementation of provideArguments(ParameterDeclarations, ExtensionContext), making it safe to use a resource such as Files.lines().