Class IterationSelector

java.lang.Object

org.junit.platform.engine.discovery.IterationSelector

All Implemented Interfaces:

DiscoverySelector

@API(status=MAINTAINED,
     since="1.13.3")
public class IterationSelector
extends Object
implements DiscoverySelector

A DiscoverySelector that selects the iterations of a parent DiscoverySelector via their indices so that TestEngines can discover a subset of the iterations of tests or containers.

Since:

1.9

See Also:

• DiscoverySelectors.selectIteration(DiscoverySelector, int...)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IterationSelector.IdentifierParser	The DiscoverySelectorIdentifierParser for IterationSelectors.

Field Summary

Fields

Modifier and Type	Field	Description
private final SortedSet<Integer>	iterationIndices
private final DiscoverySelector	parentSelector

Constructor Summary

Constructors

Constructor	Description
IterationSelector(DiscoverySelector parentSelector, int... iterationIndices)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
private String	formatIterationIndicesAsRanges()
SortedSet<Integer>	getIterationIndices()	Get the selected iteration indices.
DiscoverySelector	getParentSelector()	Get the selected parent DiscoverySelector.
int	hashCode()
Optional<DiscoverySelectorIdentifier>	toIdentifier()	Return the identifier of this selector.
private SortedSet<Integer>	toSortedSet(int[] iterationIndices)
String	toString()

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

parentSelector

private final DiscoverySelector parentSelector

iterationIndices

private final SortedSet<Integer> iterationIndices

Constructor Details

IterationSelector

IterationSelector(DiscoverySelector parentSelector,
 int... iterationIndices)

Method Details

toSortedSet

private SortedSet<Integer> toSortedSet(int[] iterationIndices)

getParentSelector

public DiscoverySelector getParentSelector()

Get the selected parent DiscoverySelector.

getIterationIndices

public SortedSet<Integer> getIterationIndices()

Get the selected iteration indices.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

toIdentifier

public Optional<DiscoverySelectorIdentifier> toIdentifier()

Description copied from interface: DiscoverySelector

Return the identifier of this selector.

The returned identifier must be parsable by a corresponding DiscoverySelectorIdentifierParser.

The default implementation returns Optional.empty(). Can be overridden by concrete implementations.

Specified by:

toIdentifier in interface DiscoverySelector

Returns:

an Optional containing the identifier of this selector; never null but potentially empty if the selector does not support identifiers

formatIterationIndicesAsRanges

private String formatIterationIndicesAsRanges()