Package junit.textui

Class TestRunner

All Implemented Interfaces:
TestListener

public class TestRunner extends BaseTestRunner
A command line based tool to run tests.
 java junit.textui.TestRunner [-wait] TestCaseClass
 

TestRunner expects the name of a TestCase class as argument. If this class defines a static suite method it will be invoked and the returned test is run. Otherwise all the methods starting with "test" having no arguments are run.

When the wait command line argument is given TestRunner waits until the users types RETURN.

TestRunner prints a trace as the tests are executed followed by a summary at the end.

  • Field Details

  • Constructor Details

    • TestRunner

      public TestRunner()
      Constructs a TestRunner.
    • TestRunner

      public TestRunner(PrintStream writer)
      Constructs a TestRunner using the given stream for all the output
    • TestRunner

      public TestRunner(ResultPrinter printer)
      Constructs a TestRunner using the given ResultPrinter all the output
  • Method Details

    • run

      public static void run(Class<? extends TestCase> testClass)
      Runs a suite extracted from a TestCase subclass.
    • run

      public static TestResult run(Test test)
      Runs a single test and collects its results. This method can be used to start a test run from your program.
       public static void main (String[] args) {
          test.textui.TestRunner.run(suite());
       }
       
    • runAndWait

      public static void runAndWait(Test suite)
      Runs a single test and waits until the user types RETURN.
    • testFailed

      public void testFailed(int status, Test test, Throwable e)
      Specified by:
      testFailed in class BaseTestRunner
    • testStarted

      public void testStarted(String testName)
      Specified by:
      testStarted in class BaseTestRunner
    • testEnded

      public void testEnded(String testName)
      Specified by:
      testEnded in class BaseTestRunner
    • createTestResult

      protected TestResult createTestResult()
      Creates the TestResult to be used for the test run.
    • doRun

      public TestResult doRun(Test test)
    • doRun

      public TestResult doRun(Test suite, boolean wait)
    • pause

      protected void pause(boolean wait)
    • main

      public static void main(String[] args)
    • start

      public TestResult start(String[] args) throws Exception
      Starts a test run. Analyzes the command line arguments and runs the given test suite.
      Throws:
      Exception
    • runSingleMethod

      protected TestResult runSingleMethod(String testCase, String method, boolean wait) throws Exception
      Throws:
      Exception
    • runFailed

      protected void runFailed(String message)
      Description copied from class: BaseTestRunner
      Override to define how to handle a failed loading of a test suite.
      Specified by:
      runFailed in class BaseTestRunner
    • setPrinter

      public void setPrinter(ResultPrinter printer)