ServiceTestCase

public abstract class ServiceTestCase
extends AndroidTestCase

此类在API级别24中已被弃用。
改为使用ServiceTestRule 。 新的测试应该使用Android Testing Support Library编写 。

此测试用例提供了一个框架，您可以在该框架中在受控环境中测试Service类。 它为服务的生命周期提供了基本的支持，并且可以使用这些钩子注入各种依赖关系并控制服务测试的环境。

生命周期支持。 按照Services文档中所述，使用特定的调用顺序访问服务。 为了支持服务的生命周期， ServiceTestCase强制执行此协议：

• The setUp() method is called before each test method. The base implementation gets the system context. If you override setUp(), you must call super.setUp() as the first statement in your override.
• The test case waits to call onCreate() until one of your test methods calls startService(Intent) or bindService(Intent). This gives you an opportunity to set up or adjust any additional framework or test logic before you test the running service.
• When one of your test methods calls ServiceTestCase.startService() or ServiceTestCase.bindService(), the test case calls Service.onCreate() and then calls either Service.startService(Intent) or Service.bindService(Intent, ServiceConnection, int), as appropriate. It also stores values needed to track and support the lifecycle.
• After each test method finishes, the test case calls the tearDown() method. This method stops and destroys the service with the appropriate calls, depending on how the service was started. If you override tearDown(), your must call the super.tearDown() as the last statement in your override.

依赖注入。 服务具有两个固有的依赖关系，其Context及其相关联的Application 。 ServiceTestCase框架允许您为这些依赖关系注入修改的，模拟的或孤立的替换项，从而在独立的环境中执行具有受控依赖项的单元测试。

默认情况下，测试用例注入完整的系统上下文和一个通用的MockApplication对象。 您可以通过调用setContext()或setApplication()来为其中的任何一个注入替代方法。 您必须在调用startService（）或bindService（） 之前执行此操作。 测试框架提供了许多用于上下文替代品，包括的MockContext ， RenamingDelegatingContext ， ContextWrapper ，和IsolatedContext 。

Summary

Inherited fields
From class android.test.AndroidTestCase protected Context mContext

Inherited methods
From class android.test.AndroidTestCase void assertActivityRequiresPermission(String packageName, String className, String permission) 断言启动给定活动受到特定权限的保护，方法是尝试启动该活动并验证 SecurityException是否在其错误消息中提及了权限。 void assertReadingContentUriRequiresPermission(Uri uri, String permission) 断言从uri内容读取需要通过查询uri获得特定许可，并确保 SecurityException提及特定权限。 void assertWritingContentUriRequiresPermission(Uri uri, String permission) 断言写入内容uri需要通过插入到uri中并确保 SecurityException特定权限 SecurityException获得特定权限。 Context getContext() void scrubClass(Class<?> testCaseClass) 这个函数在tearDown（）时间被各种TestCase实现调用，以清除任何类变量。 void setContext(Context context) void setUp() 设置夹具，例如打开网络连接。 void tearDown() 例如，关闭网络连接就可以拆卸灯具。 void testAndroidTestCaseSetupProperly()
From class junit.framework.TestCase int countTestCases() 统计run运行的测试用例的数量（TestResult结果）。 TestResult createResult() 创建一个默认的TestResult对象 String getName() 获取TestCase的名称 TestResult run() 运行此测试的便捷方法，使用默认的TestResult对象收集结果。 void run(TestResult result) 运行测试用例并在TestResult中收集结果。 void runBare() 运行裸露的测试序列。 void runTest() 重写以运行测试并声明其状态。 void setName(String name) 设置TestCase的名称 void setUp() 设置夹具，例如打开网络连接。 void tearDown() 例如，关闭网络连接就可以拆卸灯具。 String toString() 返回测试用例的字符串表示形式
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

ServiceTestCase (Class<T> serviceClass)

Public methods

Application getApplication ()

T getService ()

Context getSystemContext ()

void setApplication (Application application)

void testServiceTestCaseSetUpProperly ()

Protected methods

IBinder bindService (Intent intent)

void setUp ()

void setupService ()

void shutdownService ()

void startService (Intent intent)

void tearDown ()