Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Added in API level 3

public abstract class

ProviderTestCase2

extends AndroidTestCase

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	android.test.AndroidTestCase
			↳	android.test.ProviderTestCase2<T extends android.content.ContentProvider >

Class Overview

This test case class provides a framework for testing a single ContentProvider and for testing your app code with an isolated content provider. Instead of using the system map of providers that is based on the manifests of other applications, the test case creates its own internal map. It then uses this map to resolve providers given an authority. This allows you to inject test providers and to null out providers that you do not want to use.

This test case also sets up the following mock objects:

An IsolatedContext that stubs out Context methods that might affect the rest of the running system, while allowing tests to do real file and database work.
A MockContentResolver that provides the functionality of a regular content resolver, but uses IsolatedContext . It stubs out notifyChange(Uri, ContentObserver, boolean) to prevent the test from affecting the running system.
An instance of the provider under test, running in an IsolatedContext .

This framework is set up automatically by the base class' setUp() method. If you override this method, you must call the super method as the first statement in your override.

In order for their tests to be run, concrete subclasses must provide their own constructor with no arguments. This constructor must call , java.lang.String)">ProviderTestCase2(Class, String) as its first operation.

For more information on content provider testing, please see Content Provider Testing .

Summary

[Expand]

Inherited Fields

From class android.test.AndroidTestCase

Public Constructors
	, java.lang.String)">ProviderTestCase2 ( Class <T> providerClass, String providerAuthority) Constructor.

Public Methods
MockContentResolver	getMockContentResolver () Gets the `MockContentResolver` created by this class during initialization.
IsolatedContext	getMockContext () Gets the `IsolatedContext` created by this class during initialization.
T	getProvider () Returns the content provider created by this class in the `setUp()` method.
static <T extends ContentProvider > ContentResolver	, java.lang.String, java.lang.String, int, java.lang.String)">newResolverWithContentProviderFromSql ( Context targetContext, String filenamePrefix, Class <T> providerClass, String authority, String databaseName, int databaseVersion, String sql) Creates a new content provider of the same type as that passed to the test case class, with an authority name set to the authority parameter, and using an SQLite database as the underlying data source.

Protected Methods
void	setUp () Sets up the environment for the test fixture.
void	tearDown () Tears down the environment for the test fixture.

[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 positive 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 do not refer to the same object.
static void	assertNotSame ( String message, Object expected, Object actual) Asserts that two objects do not 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.
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 () 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 () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	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

Public Constructors

, java.lang.String)">

public ProviderTestCase2 ( Class <T> providerClass, String providerAuthority)

Added in API level 3

Constructor.

Parameters

providerClass	The class name of the provider under test
providerAuthority	The provider's authority string

Public Methods

public MockContentResolver getMockContentResolver ()

Added in API level 3

Gets the MockContentResolver created by this class during initialization. You must use the methods of this resolver to access the provider under test.

Returns

A MockContentResolver instance.

public IsolatedContext getMockContext ()

Added in API level 3

Gets the IsolatedContext created by this class during initialization.

Returns

The IsolatedContext instance

public T getProvider ()

Added in API level 3

Returns the content provider created by this class in the setUp() method.

Returns

T An instance of the provider class given as a parameter to the test case class.

, java.lang.String, java.lang.String, int, java.lang.String)">

public static ContentResolver newResolverWithContentProviderFromSql ( Context targetContext, String filenamePrefix, Class <T> providerClass, String authority, String databaseName, int databaseVersion, String sql)

Added in API level 3

Creates a new content provider of the same type as that passed to the test case class, with an authority name set to the authority parameter, and using an SQLite database as the underlying data source. The SQL statement parameter is used to create the database. This method also creates a new MockContentResolver and adds the provider to it.

Both the new provider and the new resolver are put into an IsolatedContext that uses the targetContext parameter for file operations and a MockContext for everything else. The IsolatedContext prepends the filenamePrefix parameter to file, database, and directory names.

This is a convenience method for creating a "mock" provider that can contain test data.

Parameters

targetContext	The context to use as the basis of the IsolatedContext
filenamePrefix	A string that is prepended to file, database, and directory names
providerClass	The type of the provider being tested
authority	The authority string to associated with the test provider
databaseName	The name assigned to the database
databaseVersion	The version assigned to the database
sql	A string containing the SQL statements that are needed to create the desired database and its tables. The format is the same as that generated by the sqlite3 tool's `.dump` command.

Returns

ContentResolver A new MockContentResolver linked to the provider

Throws

	IllegalAccessException
InstantiationException
IllegalAccessException

Protected Methods

protected void setUp ()

Added in API level 3

Sets up the environment for the test fixture.

Creates a new MockContentResolver , a new IsolatedContext that isolates the provider's file operations, and a new instance of the provider under test within the isolated environment.

Throws

Exception

protected void tearDown ()

Added in API level 3

Tears down the environment for the test fixture.

Calls shutdown() on the ContentProvider represented by mProvider.

Throws

Exception

Results

Interfaces

Classes

Errors

ProviderTestCase2

Class Overview

Summary

Public Constructors

public ProviderTestCase2 ( Class <T> providerClass, String providerAuthority)

Parameters

Public Methods

public MockContentResolver getMockContentResolver ()

Returns

public IsolatedContext getMockContext ()

Returns

public T getProvider ()

Returns

public static ContentResolver newResolverWithContentProviderFromSql ( Context targetContext, String filenamePrefix, Class <T> providerClass, String authority, String databaseName, int databaseVersion, String sql)

Parameters

Returns

Throws

Protected Methods

protected void setUp ()

Throws

protected void tearDown ()

Throws