| 
 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectorg.junit.runner.Request
public abstract class Request
A Request 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 of Tests. 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 ->
 a Runner is created for each class implied by the Request -> 
 the Runner returns a detailed Description 
 which is a tree structure of the tests to be run.
| Constructor Summary | |
|---|---|
| Request() | |
| Method Summary | |
|---|---|
| static Request | aClass(java.lang.Class<?> clazz)Create a Requestthat, when processed, will run all the tests
 in a class. | 
| static Request | classes(java.lang.String collectionName,
        java.lang.Class<?>... classes)Create a Requestthat, when processed, will run all the tests
 in a set of classes. | 
| static Request | classWithoutSuiteMethod(java.lang.Class<?> newTestClass) | 
| static Request | errorReport(java.lang.Class<?> klass,
            java.lang.Throwable cause) | 
|  Request | filterWith(Description desiredDescription)Returns a Request that only runs contains tests whose DescriptionequalsdesiredDescription | 
|  Request | filterWith(Filter filter)Returns a Request that only contains those tests that should run when filteris applied | 
| abstract  Runner | getRunner()Returns a Runnerfor this Request | 
| static Request | method(java.lang.Class<?> clazz,
       java.lang.String methodName)Create a Requestthat, when processed, will run a single test. | 
|  Request | sortWith(java.util.Comparator<Description> comparator)Returns a Request whose Tests can be run in a certain order, defined by comparatorFor example, here is code to run a test suite in alphabetical order: | 
| Methods inherited from class java.lang.Object | 
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | 
| Constructor Detail | 
|---|
public Request()
| Method Detail | 
|---|
public static Request method(java.lang.Class<?> clazz,
                             java.lang.String methodName)
Request 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
Request that will cause a single test be runpublic static Request aClass(java.lang.Class<?> clazz)
Request that, when processed, will run all the tests
 in a class. The odd name is necessary because class is a reserved word.
clazz - the class containing the tests
Request that will cause all tests in the class to be run
public static Request classes(java.lang.String collectionName,
                              java.lang.Class<?>... classes)
Request that, when processed, will run all the tests
 in a set of classes.
collectionName - a name to identify this suite of testsclasses - the classes containing the tests
Request that will cause all tests in the classes to be run
public static Request errorReport(java.lang.Class<?> klass,
                                  java.lang.Throwable cause)
public abstract Runner getRunner()
Runner for this Request
Runner for this Requestpublic Request filterWith(Filter filter)
filter is applied
filter - The Filter to apply to this Request
public Request filterWith(Description desiredDescription)
Description
 equals desiredDescription
desiredDescription - Description of those tests that should be run
public Request sortWith(java.util.Comparator<Description> comparator)
comparator
 
 For example, here is code to run a test suite in alphabetical order:
 
 
        private static Comparator forward() {
                return new Comparator() {
                        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
public static Request classWithoutSuiteMethod(java.lang.Class<?> newTestClass)
| 
 | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||