FileDocCategorySizeDatePackage
TestCase.javaAPI DocAndroid 1.5 API5221Wed May 06 22:41:02 BST 2009junit.framework

TestCase

public abstract class TestCase extends Assert implements Test
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 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= 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;
}
see
TestResult
see
TestSuite

Fields Summary
private String
fName
the name of the test case
Constructors Summary
public TestCase()
No-arg constructor to enable serialization. This method is not intended to be used by mere mortals without calling setName().

		fName= null;
public TestCase(String name)
Constructs a test case with the given name.

		fName= name;
Methods Summary
public intcountTestCases()
Counts the number of test cases executed by run(TestResult result).

		return 1;
protected junit.framework.TestResultcreateResult()
Creates a default TestResult object

see
TestResult

	    return new TestResult();
public java.lang.StringgetName()
Gets the name of a TestCase

return
returns a String

		return fName;
public junit.framework.TestResultrun()
A convenience method to run this test, collecting the results with a default TestResult object.

see
TestResult

		TestResult result= createResult();
		run(result);
		return result;
public voidrun(junit.framework.TestResult result)
Runs the test case and collects the results in TestResult.

		result.run(this);
public voidrunBare()
Runs the bare test sequence.

exception
Throwable if any exception is thrown

		setUp();
		try {
			runTest();
		}
		finally {
			tearDown();
		}
protected voidrunTest()
Override to run the test and assert its state.

exception
Throwable if any exception is thrown

		assertNotNull(fName);
		Method runMethod= null;
		try {
			// use getMethod to get all public inherited
			// methods. getDeclaredMethods returns all
			// methods of this class but excludes the
			// inherited ones.
			runMethod= getClass().getMethod(fName, (Class[]) null);
		} catch (NoSuchMethodException e) {
			fail("Method \""+fName+"\" not found");
		}
		if (!Modifier.isPublic(runMethod.getModifiers())) {
			fail("Method \""+fName+"\" should be public");
		}

		try {
			runMethod.invoke(this, (Object[]) new Class[0]);
		}
		catch (InvocationTargetException e) {
			e.fillInStackTrace();
			throw e.getTargetException();
		}
		catch (IllegalAccessException e) {
			e.fillInStackTrace();
			throw e;
		}
public voidsetName(java.lang.String name)
Sets the name of a TestCase

param
name The name to set

		fName= name;
protected voidsetUp()
Sets up the fixture, for example, open a network connection. This method is called before a test is executed.
protected voidtearDown()
Tears down the fixture, for example, close a network connection. This method is called after a test is executed.
public java.lang.StringtoString()
Returns a string representation of the test case

	    return getName() + "(" + getClass().getName() + ")";