Package com.sun.javatest.lib
Class TestCases
- java.lang.Object
-
- com.sun.javatest.lib.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 astatus
. 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.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description 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.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.
-
-
-
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 astatus
.- 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 astatus
.- 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 astatus
.- 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 astatus
.- 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 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
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
-
-