Package com.sun.javatest.lib
Class TestCases
java.lang.Object
com.sun.javatest.lib.TestCases
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 ClassesModifier and TypeClassDescriptionstatic class
Exception used to report internal errors. -
Constructor Summary
ConstructorsConstructorDescriptionTestCases
(Test t, PrintWriter log) Create an object to handle the test cases of the given test. -
Method Summary
Modifier and TypeMethodDescriptionReturn an enumeration of the selected test cases, based on the select and exclude calls that have been made, if any.void
Explicitly exclude a set of test cases by name.void
Explicitly exclude a set of test cases by name.Invoke each of the selected test cases, based upon the select and exclude calls that have been made, if any.protected void
Print a stack trace for an exception to the log.void
Explicitly select a set of test cases by name.void
Explicitly select a set of test cases by name.
-
Constructor Details
-
TestCases
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 Details
-
select
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 astatus
.- Throws:
TestCases.Fault
- if any of the test case names are invalid.
-
select
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 astatus
.- Throws:
TestCases.Fault
- if any of the test case names are invalid.
-
exclude
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 astatus
.- Throws:
TestCases.Fault
- if any of the test case names are invalid.
-
exclude
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 astatus
.- Throws:
TestCases.Fault
- if any of the test case names are invalid.
-
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
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 methodStatus
invokeTestCase(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
Print a stack trace for an exception to the log.- Parameters:
t
- The Throwable for which to print the trace
-