Package junit.framework
Class TestCase
java.lang.Object
junit.framework.Assert
junit.framework.TestCase
- All Implemented Interfaces:
Test
A test case defines the fixture to run multiple tests. To define a test case
- implement a subclass of
TestCase - define instance variables that store the state of the fixture
- initialize the fixture state by overriding
setUp() - clean-up after a test by overriding
tearDown().
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 Assert.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;
}
- See Also:
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic voidassertEquals(boolean expected, boolean actual) Asserts that two booleans are equal.static voidassertEquals(byte expected, byte actual) Asserts that two bytes are equal.static voidassertEquals(char expected, char actual) Asserts that two chars are equal.static voidassertEquals(double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta.static voidassertEquals(float expected, float actual, float delta) Asserts that two floats are equal concerning a delta.static voidassertEquals(int expected, int actual) Asserts that two ints are equal.static voidassertEquals(long expected, long actual) Asserts that two longs are equal.static voidassertEquals(short expected, short actual) Asserts that two shorts are equal.static voidassertEquals(Object expected, Object actual) Asserts that two objects are equal.static voidassertEquals(String message, boolean expected, boolean actual) Asserts that two booleans are equal.static voidassertEquals(String message, byte expected, byte actual) Asserts that two bytes are equal.static voidassertEquals(String message, char expected, char actual) Asserts that two chars are equal.static voidassertEquals(String message, double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta.static voidassertEquals(String message, float expected, float actual, float delta) Asserts that two floats are equal concerning a positive delta.static voidassertEquals(String message, int expected, int actual) Asserts that two ints are equal.static voidassertEquals(String message, long expected, long actual) Asserts that two longs are equal.static voidassertEquals(String message, short expected, short actual) Asserts that two shorts are equal.static voidassertEquals(String message, Object expected, Object actual) Asserts that two objects are equal.static voidassertEquals(String expected, String actual) Asserts that two Strings are equal.static voidassertEquals(String message, String expected, String actual) Asserts that two Strings are equal.static voidassertFalse(boolean condition) Asserts that a condition is false.static voidassertFalse(String message, boolean condition) Asserts that a condition is false.static voidassertNotNull(Object object) Asserts that an object isn't null.static voidassertNotNull(String message, Object object) Asserts that an object isn't null.static voidassertNotSame(Object expected, Object actual) Asserts that two objects do not refer to the same object.static voidassertNotSame(String message, Object expected, Object actual) Asserts that two objects do not refer to the same object.static voidassertNull(Object object) Asserts that an object is null.static voidassertNull(String message, Object object) Asserts that an object is null.static voidassertSame(Object expected, Object actual) Asserts that two objects refer to the same object.static voidassertSame(String message, Object expected, Object actual) Asserts that two objects refer to the same object.static voidassertTrue(boolean condition) Asserts that a condition is true.static voidassertTrue(String message, boolean condition) Asserts that a condition is true.intCounts the number of test cases executed by run(TestResult result).protected TestResultCreates a default TestResult object.static voidfail()Fails a test with no message.static voidFails a test with the given message.static voidfailNotEquals(String message, Object expected, Object actual) static voidfailNotSame(String message, Object expected, Object actual) static voidstatic StringgetName()Gets the name of a TestCase.run()A convenience method to run this test, collecting the results with a default TestResult object.voidrun(TestResult result) Runs the test case and collects the results in TestResult.voidrunBare()Runs the bare test sequence.protected voidrunTest()Override to run the test and assert its state.voidSets the name of a TestCase.protected voidsetUp()Sets up the fixture, for example, open a network connection.protected voidtearDown()Tears down the fixture, for example, close a network connection.toString()Returns a string representation of the test case.
-
Field Details
-
fName
the name of the test case
-
-
Constructor Details
-
TestCase
public TestCase()No-arg constructor to enable serialization. This method is not intended to be used by mere mortals without calling setName(). -
TestCase
Constructs a test case with the given name.
-
-
Method Details
-
countTestCases
public int countTestCases()Counts the number of test cases executed by run(TestResult result).- Specified by:
countTestCasesin interfaceTest
-
createResult
Creates a default TestResult object.- See Also:
-
run
A convenience method to run this test, collecting the results with a default TestResult object.- See Also:
-
run
Runs the test case and collects the results in TestResult. -
runBare
Runs the bare test sequence.- Throws:
Throwable- if any exception is thrown
-
runTest
Override to run the test and assert its state.- Throws:
Throwable- if any exception is thrown
-
assertTrue
Asserts that a condition is true. If it isn't it throws an AssertionFailedError with the given message. -
assertTrue
public static void assertTrue(boolean condition) Asserts that a condition is true. If it isn't it throws an AssertionFailedError. -
assertFalse
Asserts that a condition is false. If it isn't it throws an AssertionFailedError with the given message. -
assertFalse
public static void assertFalse(boolean condition) Asserts that a condition is false. If it isn't it throws an AssertionFailedError. -
fail
Fails a test with the given message. -
fail
public static void fail()Fails a test with no message. -
assertEquals
Asserts that two objects are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
Asserts that two objects are equal. If they are not an AssertionFailedError is thrown. -
assertEquals
Asserts that two Strings are equal. -
assertEquals
Asserts that two Strings are equal. -
assertEquals
Asserts that two doubles are equal concerning a delta. If they are not an AssertionFailedError is thrown with the given message. If the expected value is infinity then the delta value is ignored. -
assertEquals
public static void assertEquals(double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta. If the expected value is infinity then the delta value is ignored. -
assertEquals
Asserts that two floats are equal concerning a positive delta. If they are not an AssertionFailedError is thrown with the given message. If the expected value is infinity then the delta value is ignored. -
assertEquals
public static void assertEquals(float expected, float actual, float delta) Asserts that two floats are equal concerning a delta. If the expected value is infinity then the delta value is ignored. -
assertEquals
Asserts that two longs are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(long expected, long actual) Asserts that two longs are equal. -
assertEquals
Asserts that two booleans are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(boolean expected, boolean actual) Asserts that two booleans are equal. -
assertEquals
Asserts that two bytes are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(byte expected, byte actual) Asserts that two bytes are equal. -
assertEquals
Asserts that two chars are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(char expected, char actual) Asserts that two chars are equal. -
assertEquals
Asserts that two shorts are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(short expected, short actual) Asserts that two shorts are equal. -
assertEquals
Asserts that two ints are equal. If they are not an AssertionFailedError is thrown with the given message. -
assertEquals
public static void assertEquals(int expected, int actual) Asserts that two ints are equal. -
assertNotNull
Asserts that an object isn't null. -
assertNotNull
Asserts that an object isn't null. If it is an AssertionFailedError is thrown with the given message. -
assertNull
Asserts that an object is null. If it isn't anAssertionErroris thrown. Message contains: Expected:but was: object - Parameters:
object- Object to check ornull
-
assertNull
Asserts that an object is null. If it is not an AssertionFailedError is thrown with the given message. -
assertSame
Asserts that two objects refer to the same object. If they are not an AssertionFailedError is thrown with the given message. -
assertSame
Asserts that two objects refer to the same object. If they are not the same an AssertionFailedError is thrown. -
assertNotSame
Asserts that two objects do not refer to the same object. If they do refer to the same object an AssertionFailedError is thrown with the given message. -
assertNotSame
Asserts that two objects do not refer to the same object. If they do refer to the same object an AssertionFailedError is thrown. -
failSame
-
failNotSame
-
failNotEquals
-
format
-
setUp
Sets up the fixture, for example, open a network connection. This method is called before a test is executed.- Throws:
Exception
-
tearDown
Tears down the fixture, for example, close a network connection. This method is called after a test is executed.- Throws:
Exception
-
toString
Returns a string representation of the test case. -
getName
Gets the name of a TestCase.- Returns:
- the name of the TestCase
-
setName
Sets the name of a TestCase.- Parameters:
name- the name to set
-