Constructor Detail

• TestCases

  public TestCases(Test t,
                   java.io.PrintWriter log)

  Create an object to handle the test cases of the given test.

  Parameters:

  t - The test containing the test cases.

  log - An optional stream to which to write log messages. Use null if messages are not desired.

Method Detail

• select

  public void select(java.lang.String testCaseNames)
              throws TestCases.Fault

  Explicitly select a set of test cases by name. Subsequent calls are cumulative; if no selections are made, the default is all test cases are selected. Excluded tests will be excluded from the selection; the order of select and exclude calls does not matter.

  Parameters:

  testCaseNames - a comma-separated list of test cases names. Each name must identify a method in the test object, that takes no arguments and returns a status.

  Throws:

  TestCases.Fault - if any of the test case names are invalid.

• select

  public void select(java.lang.String[] testCaseNames)
              throws TestCases.Fault

  Explicitly select a set of test cases by name. Subsequent calls are cumulative; if no selections are made, the default is all test cases are selected. Excluded tests will be excluded from the selection; the order of select and exclude calls does not matter.

  Parameters:

  testCaseNames - an array of test cases names. Each name must identify a method in the test object, that takes no arguments and returns a status.

  Throws:

  TestCases.Fault - if any of the test case names are invalid.

• exclude

  public void exclude(java.lang.String testCaseNames)
               throws TestCases.Fault

  Explicitly exclude a set of test cases by name. Subsequent calls are cumulative; by default, no test cases are excluded.

  Parameters:

  testCaseNames - a comma-separated list of test cases names. Each name must identify a method in the test object, that takes no arguments and returns a status.

  Throws:

  TestCases.Fault - if any of the test case names are invalid.

• exclude

  public void exclude(java.lang.String[] testCaseNames)
               throws TestCases.Fault

  Explicitly exclude a set of test cases by name. Subsequent calls are cumulative; by default, no test cases are excluded.

  Parameters:

  testCaseNames - an array of test cases names. Each name must identify a method in the test object, that takes no arguments and returns a status.

  Throws:

  TestCases.Fault - if any of the test case names are invalid.

• enumerate

  public java.util.Enumeration enumerate()

  Return an enumeration of the selected test cases, based on the select and exclude calls that have been made, if any.

  Returns:

  An enumeration of the test cases.

• invokeTestCases

  public Status invokeTestCases()

  Invoke each of the selected test cases, based upon the select and exclude calls that have been made, if any. If the test object provides a public method StatusinvokeTestCase(Method) that method will be called to invoke the test cases; otherwise, the test cases will be invoked directly. It is an error if no test cases are selected, (or if they have all been excluded.)

  Returns:

  the combined result of executing all the test cases.

• printStackTrace

  protected void printStackTrace(java.lang.Throwable t)

  Print a stack trace for an exception to the log.

  Parameters:

  t - The Throwable for which to print the trace