TestCase

public abstract class TestCase
extends Assert implements Test

java.lang.Object
	junit.framework.Assert
		junit.framework.TestCase

Known Direct Subclasses AndroidTestCase, InstrumentationTestCase, TestSuiteBuilder.FailedToCreateTests AndroidTestCase 此类已在API级别24中弃用。请改为使用InstrumentationRegistry 。 新的测试应使用Android Testing Support Library编写 。 InstrumentationTestCase 此类已在API级别24中弃用。请改为使用InstrumentationRegistry 。 新的测试应该使用Android Testing Support Library编写 。 TestSuiteBuilder.FailedToCreateTests 一个特殊的 TestCase用于在build（）步骤中指示失败。

Known Indirect Subclasses ActivityInstrumentationTestCase<T extends  Activity>, ActivityInstrumentationTestCase2<T extends  Activity>, ActivityTestCase, ActivityUnitTestCase<T extends  Activity>, ApplicationTestCase<T extends  Application>, LoaderTestCase, ProviderTestCase<T extends  ContentProvider>, ProviderTestCase2<T extends  ContentProvider>, ServiceTestCase<T extends  Service>, SingleLaunchActivityTestCase<T extends  Activity>, SyncBaseInstrumentation ActivityInstrumentationTestCase<T extends Activity> 此类在API级别3中已被弃用。应使用ActivityInstrumentationTestCase2编写新测试，它提供了更多选项来配置被测活动 ActivityInstrumentationTestCase2<T extends Activity> 此类已在API级别24中弃用。请改为使用ActivityTestRule 。 新的测试应该使用Android Testing Support Library编写 。 ActivityTestCase 该类在API级别24中已弃用。应使用Android Testing Support Library编写新测试。 ActivityUnitTestCase<T extends Activity> 此类已在API级别24中弃用。 请改为写入Local Unit Tests 。 ApplicationTestCase<T extends Application> 此类已在API级别24中弃用。请改为使用InstrumentationRegistry 。 新的测试应该使用Android Testing Support Library编写 。 LoaderTestCase 用于测试 Loader的便利课程。 ProviderTestCase<T extends ContentProvider> 此类在API级别3中已弃用。此类扩展了InstrumentationTestCase，但应扩展AndroidTestCase。 改为使用ProviderTestCase2来解决这个问题。 ProviderTestCase2<T extends ContentProvider> 此测试用例类提供了一个框架，用于测试单个 ContentProvider并使用独立内容提供程序测试您的应用程序代码。 ServiceTestCase<T extends Service> 此类已在API级别24中弃用。请改为使用ServiceTestRule 。 新的测试应该使用Android Testing Support Library编写 。 SingleLaunchActivityTestCase<T extends Activity> 此类已在API级别24中弃用。请改为使用ActivityTestRule 。 新的测试应该使用Android Testing Support Library编写 。 SyncBaseInstrumentation 此类已在API级别24中弃用。请改为使用InstrumentationRegistry 。 新的测试应该使用Android Testing Support Library来编写。

---

测试用例定义了灯具运行多个测试。 定义一个测试用例

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() 无参数构造函数来启用序列化。
TestCase(String name) 用给定的名字构造一个测试用例。

公共方法(Public methods)
int	countTestCases() 统计run运行的测试用例的数量（TestResult结果）。
String	getName() 获取TestCase的名称
TestResult	run() 运行此测试的便捷方法，使用默认的TestResult对象收集结果。
void	run(TestResult result) 运行测试用例并在TestResult中收集结果。
void	runBare() 运行裸露的测试序列。
void	setName(String name) 设置TestCase的名称
String	toString() 返回测试用例的字符串表示形式

Protected methods
TestResult	createResult() 创建一个默认的TestResult对象
void	runTest() 重写以运行测试并声明其状态。
void	setUp() 设置夹具，例如打开网络连接。
void	tearDown() 例如，关闭网络连接就可以拆卸灯具。

继承方法(Inherited methods)
From class junit.framework.Assert static void assertEquals(boolean expected, boolean actual) 断言两个布尔值是平等的。 static void assertEquals(String message, long expected, long actual) 断言两个长期是平等的。 static void assertEquals(short expected, short actual) 断言两条短裤是平等的。 static void assertEquals(String message, String expected, String actual) 断言两个字符串是平等的。 static void assertEquals(String message, int expected, int actual) 断言两个整数是相等的。 static void assertEquals(Object expected, Object actual) 断言两个对象是平等的。 static void assertEquals(String message, boolean expected, boolean actual) 断言两个布尔值是平等的。 static void assertEquals(String expected, String actual) 断言两个字符串是平等的。 static void assertEquals(String message, short expected, short actual) 断言两条短裤是平等的。 static void assertEquals(String message, Object expected, Object actual) 断言两个对象是平等的。 static void assertEquals(char expected, char actual) 断言两个字符是平等的。 static void assertEquals(byte expected, byte actual) 断言两个字节相等。 static void assertEquals(double expected, double actual, double delta) 断言两个双打在三角洲是平等的。 static void assertEquals(String message, char expected, char actual) 断言两个字符是平等的。 static void assertEquals(float expected, float actual, float delta) 断言两个浮标在三角洲上是平等的。 static void assertEquals(String message, double expected, double actual, double delta) 断言两个双打在三角洲是平等的。 static void assertEquals(String message, byte expected, byte actual) 断言两个字节相等。 static void assertEquals(String message, float expected, float actual, float delta) 断言两个浮标在正三角洲上是平等的。 static void assertEquals(long expected, long actual) 断言两个长期是平等的。 static void assertEquals(int expected, int actual) 断言两个整数是相等的。 static void assertFalse(String message, boolean condition) 断言条件是错误的。 static void assertFalse(boolean condition) 断言条件是错误的。 static void assertNotNull(Object object) 声明一个对象不为null。 static void assertNotNull(String message, Object object) 声明一个对象不为null。 static void assertNotSame(String message, Object expected, Object actual) 断言两个对象不会引用同一个对象。 static void assertNotSame(Object expected, Object actual) 断言两个对象不会引用同一个对象。 static void assertNull(String message, Object object) 断言对象为空。 static void assertNull(Object object) 断言对象为空。 static void assertSame(String message, Object expected, Object actual) 断言两个对象引用同一个对象。 static void assertSame(Object expected, Object actual) 断言两个对象引用同一个对象。 static void assertTrue(String message, boolean condition) 断言条件是真实的。 static void assertTrue(boolean condition) 断言条件是真实的。 static void fail(String message) 对给定的消息不成功。 static void fail() 没有消息的测试失败。 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() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用方法 notify()或方法 notifyAll() ，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface junit.framework.Test abstract int countTestCases() 计算将由此测试运行的测试用例的数量。 abstract void run(TestResult result) 运行测试并将其结果收集到TestResult实例中。

Public constructors

公共方法(Public methods)

Protected methods