TestCase

Class Overview

A test case defines the fixture to run multiple tests. To define a test case

1. implement a subclass of TestCase
2. define instance variables that store the state of the fixture
3. initialize the fixture state by overriding setUp()
4. clean-up after a test by overriding tearDown().

Each test runs in its own fixture so there can be no side effects among test runs. Here is an example:

 public class MathTest extends TestCase {
    protected double fValue1;
    protected double fValue2;

    protected void setUp() {
       fValue1= 2.0;
       fValue2= 3.0;
    }
 }
 

For each test implement a method which interacts with the fixture. Verify the expected results with assertions specified by calling assertTrue(String, boolean) with a boolean.

    public void testAdd() {
       double result= fValue1 + fValue2;
       assertTrue(result == 5.0);
    }
 

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.

 TestCase test= new MathTest("add") {
    public void runTest() {
       testAdd();
    }
 };
 test.run();
 

The dynamic way uses reflection to implement 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");
 test.run();
 

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 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;
 }
 

Summary

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.

[Expand] Inherited Methods
From class junit.framework.Assert static void assertEquals(short expected, short actual) Asserts that two shorts are equal. static void assertEquals( String message, int expected, int actual) Asserts that two ints are equal. static void assertEquals( String message, short expected, short actual) Asserts that two shorts are equal. static void assertEquals(char expected, char actual) Asserts that two chars are equal. static void assertEquals( String message, String expected, String actual) Asserts that two Strings are equal. static void assertEquals(int expected, int actual) Asserts that two ints are equal. static void assertEquals( String message, double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta. static void assertEquals( String message, long expected, long actual) Asserts that two longs are equal. static void assertEquals(byte expected, byte actual) Asserts that two bytes are equal. static void assertEquals( Object expected, Object actual) Asserts that two objects are equal. static void assertEquals(boolean expected, boolean actual) Asserts that two booleans are equal. static void assertEquals( String message, float expected, float actual, float delta) Asserts that two floats are equal concerning a positive delta. static void assertEquals( String message, boolean expected, boolean actual) Asserts that two booleans are equal. static void assertEquals( String expected, String actual) Asserts that two Strings are equal. static void assertEquals(float expected, float actual, float delta) Asserts that two floats are equal concerning a delta. static void assertEquals( String message, byte expected, byte actual) Asserts that two bytes are equal. static void assertEquals(double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta. static void assertEquals( String message, char expected, char actual) Asserts that two chars are equal. static void assertEquals( String message, Object expected, Object actual) Asserts that two objects are equal. static void assertEquals(long expected, long actual) Asserts that two longs are equal. static void assertFalse( String message, boolean condition) Asserts that a condition is false. static void assertFalse(boolean condition) Asserts that a condition is false. static void assertNotNull( String message, Object object) Asserts that an object isn't null. static void assertNotNull( Object object) Asserts that an object isn't null. static void assertNotSame( Object expected, Object actual) Asserts that two objects do not refer to the same object. static void assertNotSame( String message, Object expected, Object actual) Asserts that two objects do not refer to the same object. static void assertNull( Object object) Asserts that an object is null. static void assertNull( String message, Object object) Asserts that an object is null. static void assertSame( Object expected, Object actual) Asserts that two objects refer to the same object. static void assertSame( String message, Object expected, Object actual) Asserts that two objects refer to the same object. static void assertTrue( String message, boolean condition) Asserts that a condition is true. static void assertTrue(boolean condition) Asserts that a condition is true. static void fail( String message) Fails a test with the given message. static void fail() Fails a test with no message. static void failNotEquals( String message, Object expected, Object actual) static void failNotSame( String message, Object expected, Object actual) static void failSame( String message) static String format( String message, Object expected, Object actual)
From class java.lang.Object Object clone() Creates and returns a copy of this Object. boolean equals( Object o) Compares this instance with the specified object and indicates if they are equal. void finalize() Invoked when the garbage collector has detected that this instance is no longer reachable. final Class<?> getClass() Returns the unique instance of Class that represents this object's class. int hashCode() Returns an integer hash code for this object. final void notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. final void notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. String toString() Returns a string containing a concise, human-readable description of this object. final void wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object. final void wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires. final void wait(long millis) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
From interface junit.framework.Test abstract int countTestCases() Counts the number of test cases that will be run by this test. abstract void run( TestResult result) Runs a test and collects its result in a TestResult instance.