ServiceTestCase

Class Overview

This test case provides a framework in which you can test Service classes in a controlled environment. It provides basic support for the lifecycle of a Service, and hooks with which you can inject various dependencies and control the environment in which your Service is tested.

Lifecycle Support. A Service is accessed with a specific sequence of calls, as documented in the section Service lifecycle in the Developer Guide. In order to support the lifecycle of a Service, ServiceTestCase enforces this protocol:

• 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.

Dependency Injection. A service has two inherent dependencies, its Context and its associated Application. The ServiceTestCase framework allows you to inject modified, mock, or isolated replacements for these dependencies, and thus perform unit tests with controlled dependencies in an isolated environment.

By default, the test case is injected with a full system context and a generic MockApplication object. You can inject alternatives to either of these by invoking setContext() or setApplication(). You must do this before calling startService() or bindService(). The test framework provides a number of alternatives for Context, including {link android.test.mock.MockContext MockContext}, RenamingDelegatingContext, ContextWrapper, and IsolatedContext.

Summary

[Expand] Inherited Fields
From class android.test.AndroidTestCase protected Context mContext

[Expand] Inherited Methods
From class android.test.AndroidTestCase void assertActivityRequiresPermission(String packageName, String className, String permission) Asserts that launching a given activity is protected by a particular permission by attempting to start the activity and validating that a SecurityException is thrown that mentions the permission in its error message. void assertReadingContentUriRequiresPermission(Uri uri, String permission) Asserts that reading from the content uri requires a particular permission by querying the uri and ensuring a SecurityException is thrown mentioning the particular permission. void assertWritingContentUriRequiresPermission(Uri uri, String permission) Asserts that writing to the content uri requires a particular permission by inserting into the uri and ensuring a SecurityException is thrown mentioning the particular permission. Context getContext() void scrubClass(Class<?> testCaseClass) This function is called by various TestCase implementations, at tearDown() time, in order to scrub out any class variables. void setContext(Context context) void setUp() Sets up the fixture, for example, open a network connection. void tearDown() Tears down the fixture, for example, close a network connection. void testAndroidTestCaseSetupProperly()
From class junit.framework.TestCase int countTestCases() Counts the number of test cases executed by run(TestResult result). TestResult createResult() Creates a default TestResult object 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 runTest() Override to run the test and assert its state. void setName(String name) Sets the name of a TestCase void setUp() Sets up the fixture, for example, open a network connection. void tearDown() Tears down the fixture, for example, close a network connection. String toString() Returns a string representation of the test case
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 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 refer to the same object. static void assertNotSame(String message, Object expected, Object actual) Asserts that two objects 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.
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() Called before the object's memory is reclaimed by the VM. final Class<? extends Object> 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.