org.junit.runner.Runner Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jmockit

There is a newer version: 0.999.4

package org.junit.runner;

import org.junit.runner.notification.RunNotifier;

import mockit.internal.startup.*;

/**
 * A Runner runs tests and notifies a {@link org.junit.runner.notification.RunNotifier}
 * of significant events as it does so. You will need to subclass Runner
 * when using {@link org.junit.runner.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 {@link 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.
 *
 * @see org.junit.runner.Description
 * @see org.junit.runner.RunWith
 */
public abstract class Runner implements Describable
{
   static
   {
      Startup.verifyInitialization();
   }

   public abstract Description getDescription();

   /**
    * Run the tests for this runner.
    *
    * @param notifier will be notified of events while tests are being run--tests being
    *                 started, finishing, and failing
    */
   public abstract void run(RunNotifier notifier);

   /**
    * @return the number of tests to be run by the receiver
    */
   public int testCount()
   {
      return getDescription().testCount();
   }
}