程序包 org.junit.runner
类 Request
- java.lang.Object
- org.junit.runner.Request
public abstract class Request extends Object
ARequest
is an abstract description of tests to be run. Older versions of JUnit did not need such a concept--tests to be run were described either by classes containing tests or a tree ofTest
s. However, we want to support filtering and sorting, so we need a more abstract specification than the tests themselves and a richer specification than just the classes.The flow when JUnit runs tests is that a
Request
specifies some tests to be run -> aRunner
is created for each class implied by theRequest
-> theRunner
returns a detailedDescription
which is a tree structure of the tests to be run.- 从以下版本开始:
- 4.0
构造器概要
构造器 构造器 说明 Request()
方法概要
所有方法 静态方法 实例方法 抽象方法 具体方法 修饰符和类型 方法 说明 static Request
aClass(Class<?> clazz)
Create aRequest
that, when processed, will run all the tests in a class.static Request
classes(Class<?>... classes)
Create aRequest
that, when processed, will run all the tests in a set of classes with the defaultComputer
.static Request
classes(Computer computer, Class<?>... classes)
Create aRequest
that, when processed, will run all the tests in a set of classes.static Request
classWithoutSuiteMethod(Class<?> clazz)
Create aRequest
that, when processed, will run all the tests in a class.static Request
errorReport(Class<?> klass, Throwable cause)
Creates aRequest
that, when processed, will report an error for the given test class with the given cause.Request
filterWith(Description desiredDescription)
Returns a Request that only runs contains tests whoseDescription
equalsdesiredDescription
Request
filterWith(Filter filter)
Returns a Request that only contains those tests that should run whenfilter
is appliedabstract Runner
getRunner()
Returns aRunner
for this Requeststatic Request
method(Class<?> clazz, String methodName)
Create aRequest
that, when processed, will run a single test.static Request
runner(Runner runner)
Request
sortWith(Comparator<Description> comparator)
Returns a Request whose Tests can be run in a certain order, defined bycomparator
构造器详细资料
Request
public Request()
方法详细资料
method
public static Request method(Class<?> clazz, String methodName)
Create aRequest
that, when processed, will run a single test. This is done by filtering out all other tests. This method is used to support rerunning single tests.- 参数:
clazz
- the class of the testmethodName
- the name of the test- 返回:
- a
Request
that will cause a single test be run
aClass
public static Request aClass(Class<?> clazz)
Create aRequest
that, when processed, will run all the tests in a class. The odd name is necessary becauseclass
is a reserved word.- 参数:
clazz
- the class containing the tests- 返回:
- a
Request
that will cause all tests in the class to be run
classWithoutSuiteMethod
public static Request classWithoutSuiteMethod(Class<?> clazz)
Create aRequest
that, when processed, will run all the tests in a class. If the class has a suite() method, it will be ignored.- 参数:
clazz
- the class containing the tests- 返回:
- a
Request
that will cause all tests in the class to be run
classes
public static Request classes(Computer computer, Class<?>... classes)
Create aRequest
that, when processed, will run all the tests in a set of classes.- 参数:
computer
- Helps construct Runners from classesclasses
- the classes containing the tests- 返回:
- a
Request
that will cause all tests in the classes to be run
classes
public static Request classes(Class<?>... classes)
Create aRequest
that, when processed, will run all the tests in a set of classes with the defaultComputer
.- 参数:
classes
- the classes containing the tests- 返回:
- a
Request
that will cause all tests in the classes to be run
errorReport
public static Request errorReport(Class<?> klass, Throwable cause)
Creates aRequest
that, when processed, will report an error for the given test class with the given cause.
runner
public static Request runner(Runner runner)
- 参数:
runner
- the runner to return- 返回:
- a
Request
that will run the given runner when invoked
getRunner
public abstract Runner getRunner()
Returns aRunner
for this Request- 返回:
- corresponding
Runner
for this Request
filterWith
public Request filterWith(Filter filter)
Returns a Request that only contains those tests that should run whenfilter
is applied- 参数:
filter
- TheFilter
to apply to this Request- 返回:
- the filtered Request
filterWith
public Request filterWith(Description desiredDescription)
Returns a Request that only runs contains tests whoseDescription
equalsdesiredDescription
- 参数:
desiredDescription
-Description
of those tests that should be run- 返回:
- the filtered Request
sortWith
public Request sortWith(Comparator<Description> comparator)
Returns a Request whose Tests can be run in a certain order, defined bycomparator
For example, here is code to run a test suite in alphabetical order:
private static Comparator<Description> forward() { return new Comparator<Description>() { public int compare(Description o1, Description o2) { return o1.getDisplayName().compareTo(o2.getDisplayName()); } }; } public static main() { new JUnitCore().run(Request.aClass(AllTests.class).sortWith(forward())); }
- 参数:
comparator
- definition of the order of the tests in this Request- 返回:
- a Request with ordered Tests