Package org.junit.runner.manipulation
Class Filter
java.lang.Object
org.junit.runner.manipulation.Filter
- Direct Known Subclasses:
Categories.CategoryFilter
The canonical case of filtering is when you want to run a single test method in a class. Rather
than introduce runner API just for that one case, JUnit provides a general filtering mechanism.
If you want to filter the tests to be run, extend
Filter
and apply an instance of
your filter to the Request
before running it (see
JUnitCore.run(Request)
. Alternatively, apply a Filter
to
a Runner
before running tests (for example, in conjunction with
RunWith
.- Since:
- 4.0
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Invoke with aRunner
to cause all tests it intends to run to first be checked with the filter.abstract String
describe()
Returns a textual description of this FilterReturns a new Filter that accepts the intersection of the tests accepted by this Filter andsecond
static Filter
matchMethodDescription
(Description desiredDescription) Returns aFilter
that only runs the single method described bydesiredDescription
abstract boolean
shouldRun
(Description description)
-
Field Details
-
ALL
A nullFilter
that passes all tests through.
-
-
Constructor Details
-
Filter
public Filter()
-
-
Method Details
-
matchMethodDescription
Returns aFilter
that only runs the single method described bydesiredDescription
-
shouldRun
- Parameters:
description
- the description of the test to be run- Returns:
true
if the test should be run
-
describe
Returns a textual description of this Filter- Returns:
- a textual description of this Filter
-
apply
Invoke with aRunner
to cause all tests it intends to run to first be checked with the filter. Only those that pass the filter will be run.- Parameters:
child
- the runner to be filtered by the receiver- Throws:
NoTestsRemainException
- if the receiver removes all tests
-
intersect
Returns a new Filter that accepts the intersection of the tests accepted by this Filter andsecond
-