Class Runner

java.lang.Object
org.junit.runner.Runner
All Implemented Interfaces:
Describable
Direct Known Subclasses:
ErrorReportingRunner, IgnoredClassRunner, JUnit38ClassRunner, JUnit4ClassRunner, Parameterized.AssumptionViolationRunner, ParentRunner

public abstract class Runner extends Object implements Describable
A Runner runs tests and notifies a RunNotifier of significant events as it does so. You will need to subclass Runner when using RunWith to invoke a custom runner. When creating a custom runner, in addition to implementing the abstract methods here you must also provide a constructor that takes as an argument the Class containing the tests.

The default runner implementation guarantees that the instances of the test case class will be constructed immediately before running the test and that the runner will retain no reference to the test case instances, generally making them available for garbage collection.

Since:
4.0
See Also:
  • Constructor Details

    • Runner

      public Runner()
  • Method Details

    • getDescription

      public abstract Description getDescription()
      Specified by:
      getDescription in interface Describable
      Returns:
      a Description showing the tests to be run by the receiver
    • run

      public abstract void run(RunNotifier notifier)
      Run the tests for this runner.
      Parameters:
      notifier - will be notified of events while tests are being run--tests being started, finishing, and failing
    • testCount

      public int testCount()
      Returns:
      the number of tests to be run by the receiver