Package org.junit.platform.launcher
Class EngineFilter
java.lang.Object
org.junit.platform.launcher.EngineFilter
- All Implemented Interfaces:
Filter<TestEngine>
@API(status=STABLE,
since="1.0")
public class EngineFilter
extends Object
implements Filter<TestEngine>
An
EngineFilter
is applied to all TestEngines
before they are used.
Warning: be cautious when registering multiple competing
include
EngineFilters
or multiple competing
exclude
EngineFilters
for the same discovery
request since doing so will likely lead to undesirable results (i.e., zero
engines being active).
- Since:
- 1.0
- See Also:
-
Nested Class Summary
Nested Classes -
Field Summary
Fields -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivate
EngineFilter
(List<String> engineIds, EngineFilter.Type type) -
Method Summary
Modifier and TypeMethodDescriptionapply
(TestEngine testEngine) Apply this filter to the supplied object.static EngineFilter
excludeEngines
(String... engineIds) Create a new excludeEngineFilter
based on the supplied engine IDs.static EngineFilter
excludeEngines
(List<String> engineIds) Create a new excludeEngineFilter
based on the supplied engine IDs.static EngineFilter
includeEngines
(String... engineIds) Create a new includeEngineFilter
based on the supplied engine IDs.static EngineFilter
includeEngines
(List<String> engineIds) Create a new includeEngineFilter
based on the supplied engine IDs.boolean
toString()
validateAndTrim
(List<String> engineIds) Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.junit.platform.engine.Filter
toPredicate
-
Field Details
-
engineIds
-
type
-
-
Constructor Details
-
EngineFilter
-
-
Method Details
-
includeEngines
Create a new includeEngineFilter
based on the supplied engine IDs.Only
TestEngines
with matching engine IDs will be included within the test discovery and execution.- Parameters:
engineIds
- the list of engine IDs to match against; nevernull
or empty; individual IDs must also not be null or blank- See Also:
-
includeEngines
Create a new includeEngineFilter
based on the supplied engine IDs.Only
TestEngines
with matching engine IDs will be included within the test discovery and execution.- Parameters:
engineIds
- the list of engine IDs to match against; nevernull
or empty; individual IDs must also not be null or blank- See Also:
-
excludeEngines
Create a new excludeEngineFilter
based on the supplied engine IDs.TestEngines
with matching engine IDs will be excluded from test discovery and execution.- Parameters:
engineIds
- the list of engine IDs to match against; nevernull
or empty; individual IDs must also not be null or blank- See Also:
-
excludeEngines
Create a new excludeEngineFilter
based on the supplied engine IDs.TestEngines
with matching engine IDs will be excluded from test discovery and execution.- Parameters:
engineIds
- the list of engine IDs to match against; nevernull
or empty; individual IDs must also not be null or blank- See Also:
-
getEngineIds
-
isIncludeFilter
@API(status=INTERNAL, since="1.9") public boolean isIncludeFilter() -
apply
Description copied from interface:Filter
Apply this filter to the supplied object.- Specified by:
apply
in interfaceFilter<TestEngine>
-
toString
-
validateAndTrim
-