public
abstract
class
TestCase
extends Assert
implements
Test
java.lang.Object | ||
↳ | junit.framework.Assert | |
↳ | junit.framework.TestCase |
A test case defines the fixture to run multiple tests. To define a test case
TestCase
setUp()
tearDown()
.public class MathTest extends TestCase {For each test implement a method which interacts with the fixture. Verify the expected results with assertions specified by calling
protected double fValue1;
protected double fValue2;
protected void setUp() {
fValue1= 2.0;
fValue2= 3.0;
}
}
Assert.assertTrue(String, boolean)
with a boolean.
public void testAdd() {Once the methods are defined you can run them. The framework supports both a static type safe and more dynamic way to run a test. In the static way you override the runTest method and define the method to be invoked. A convenient way to do so is with an anonymous inner class.
double result= fValue1 + fValue2;
assertTrue(result == 5.0);
}
TestCase test= new MathTest("add") {The dynamic way uses reflection to implement
public void runTest() {
testAdd();
}
};
test.run();
runTest()
. It dynamically finds
and invokes a method.
In this case the name of the test case has to correspond to the test method
to be run.
TestCase test= new MathTest("testAdd");The tests to be run can be collected into a TestSuite. JUnit provides different test runners which can run a test suite and collect the results. A test runner either expects a static method
test.run();
suite
as the entry
point to get a test to run or it will extract the suite automatically.
public static Test suite() {
suite.addTest(new MathTest("testAdd"));
suite.addTest(new MathTest("testDivideByZero"));
return suite;
}
See also:
Public constructors | |
---|---|
TestCase()
No-arg constructor to enable serialization. |
|
TestCase(String name)
Constructs a test case with the given name. |
Public methods | |
---|---|
int
|
countTestCases()
Counts the number of test cases executed by run(TestResult result). |
String
|
getName()
Gets the name of a TestCase |
TestResult
|
run()
A convenience method to run this test, collecting the results with a default TestResult object. |
void
|
run(TestResult result)
Runs the test case and collects the results in TestResult. |
void
|
runBare()
Runs the bare test sequence. |
void
|
setName(String name)
Sets the name of a TestCase |
String
|
toString()
Returns a string representation of the test case |
Protected methods | |
---|---|
TestResult
|
createResult()
Creates a default TestResult object |
void
|
runTest()
Override to run the test and assert its state. |
void
|
setUp()
Sets up the fixture, for example, open a network connection. |
void
|
tearDown()
Tears down the fixture, for example, close a network connection. |
Inherited methods | |
---|---|
public TestCase ()
No-arg constructor to enable serialization. This method is not intended to be used by mere mortals without calling setName().
public TestCase (String name)
Constructs a test case with the given name.
Parameters | |
---|---|
name |
String |
public int countTestCases ()
Counts the number of test cases executed by run(TestResult result).
Returns | |
---|---|
int |
public String getName ()
Gets the name of a TestCase
Returns | |
---|---|
String |
the name of the TestCase |
public TestResult run ()
A convenience method to run this test, collecting the results with a default TestResult object.
Returns | |
---|---|
TestResult |
See also:
public void run (TestResult result)
Runs the test case and collects the results in TestResult.
Parameters | |
---|---|
result |
TestResult |
public void runBare ()
Runs the bare test sequence.
Throws | |
---|---|
Throwable |
if any exception is thrown |
public void setName (String name)
Sets the name of a TestCase
Parameters | |
---|---|
name |
String : the name to set |
public String toString ()
Returns a string representation of the test case
Returns | |
---|---|
String |
a string representation of the object. |
protected TestResult createResult ()
Creates a default TestResult object
Returns | |
---|---|
TestResult |
See also:
protected void runTest ()
Override to run the test and assert its state.
Throws | |
---|---|
Throwable |
if any exception is thrown |
protected void setUp ()
Sets up the fixture, for example, open a network connection. This method is called before a test is executed.
Throws | |
---|---|
Exception |
protected void tearDown ()
Tears down the fixture, for example, close a network connection. This method is called after a test is executed.
Throws | |
---|---|
Exception |