Class TestCases


  • public class TestCases
    extends java.lang.Object
    A handler for the set of test cases in a test. Test cases are those methods with no args that return a status. Test cases can be explicitly selected into or excluded from the set.
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  TestCases.Fault
      Exception used to report internal errors.
    • Constructor Summary

      Constructors 
      Constructor Description
      TestCases​(Test t, java.io.PrintWriter log)
      Create an object to handle the test cases of the given test.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.util.Enumeration<java.lang.reflect.Method> enumerate()
      Return an enumeration of the selected test cases, based on the select and exclude calls that have been made, if any.
      void exclude​(java.lang.String testCaseNames)
      Explicitly exclude a set of test cases by name.
      void exclude​(java.lang.String... testCaseNames)
      Explicitly exclude a set of test cases by name.
      Status invokeTestCases()
      Invoke each of the selected test cases, based upon the select and exclude calls that have been made, if any.
      protected void printStackTrace​(java.lang.Throwable t)
      Print a stack trace for an exception to the log.
      void select​(java.lang.String testCaseNames)
      Explicitly select a set of test cases by name.
      void select​(java.lang.String... testCaseNames)
      Explicitly select a set of test cases by name.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 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<java.lang.reflect.Method> 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