org.robolectric.shadows

Class ShadowContentResolver

java.lang.Object

org.robolectric.shadows.ShadowContentResolver

@Implements(value=android.content.ContentResolver.class)
public class ShadowContentResolver
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ShadowContentResolver.DeleteStatement A statement used to delete content in a ContentProvider.
static class	ShadowContentResolver.InsertStatement A statement used to insert content into a ContentProvider.
static class	ShadowContentResolver.NotifiedUri
static class	ShadowContentResolver.Statement A statement used to modify content in a ContentProvider.
static class	ShadowContentResolver.Status
static class	ShadowContentResolver.UpdateStatement A statement used to update content in a ContentProvider.

Constructor Summary

Constructors

Constructor and Description
ShadowContentResolver()

Method Summary

Modifier and Type	Method and Description
android.content.ContentProviderClient	acquireContentProviderClient(java.lang.String name)
android.content.ContentProviderClient	acquireContentProviderClient(android.net.Uri uri)
android.content.IContentProvider	acquireProvider(java.lang.String name)
android.content.IContentProvider	acquireProvider(android.net.Uri uri)
android.content.ContentProviderClient	acquireUnstableContentProviderClient(java.lang.String name)
android.content.ContentProviderClient	acquireUnstableContentProviderClient(android.net.Uri uri)
android.content.IContentProvider	acquireUnstableProvider(java.lang.String name)
android.content.IContentProvider	acquireUnstableProvider(android.net.Uri uri)
static void	addPeriodicSync(android.accounts.Account account, java.lang.String authority, android.os.Bundle extras, long pollFrequency)
android.content.ContentProviderResult[]	applyBatch(java.lang.String authority, java.util.ArrayList<android.content.ContentProviderOperation> operations)
int	bulkInsert(android.net.Uri url, android.content.ContentValues[] values) If a ContentProvider is registered for the given Uri, its ContentProvider.bulkInsert(Uri, ContentValues[]) method will be invoked.
android.os.Bundle	call(android.net.Uri uri, java.lang.String method, java.lang.String arg, android.os.Bundle extras)
static void	cancelSync(android.accounts.Account account, java.lang.String authority)
void	clearContentObservers() Deprecated. Do not use this method.
int	delete(android.net.Uri url, java.lang.String where, java.lang.String[] selectionArgs) If a ContentProvider is registered for the given Uri, its ContentProvider.delete(Uri, String, String[]) method will be invoked.
java.util.Collection<android.database.ContentObserver>	getContentObservers(android.net.Uri uri) Returns the content observers registered for updates under the given URI.
java.util.List<android.content.ContentProviderOperation>	getContentProviderOperations(java.lang.String authority)
java.util.List<android.net.Uri>	getDeletedUris()
java.util.List<ShadowContentResolver.DeleteStatement>	getDeleteStatements() Returns the list of ShadowContentResolver.DeleteStatements for corresponding calls to ContentResolver.delete(Uri, String, String[]).
java.util.List<ShadowContentResolver.InsertStatement>	getInsertStatements() Returns the list of ShadowContentResolver.InsertStatements for corresponding calls to ContentResolver.insert(Uri, ContentValues) or ContentResolver.bulkInsert(Uri, ContentValues[]).
static int	getIsSyncable(android.accounts.Account account, java.lang.String authority)
static boolean	getMasterSyncAutomatically()
java.util.List<ShadowContentResolver.NotifiedUri>	getNotifiedUris()
static java.util.List<android.content.PeriodicSync>	getPeriodicSyncs(android.accounts.Account account, java.lang.String authority)
java.util.List<android.content.UriPermission>	getPersistedUriPermissions()
static android.content.ContentProvider	getProvider(android.net.Uri uri)
java.util.List<ShadowContentResolver.Statement>	getStatements() Returns the list of ShadowContentResolver.InsertStatements, ShadowContentResolver.UpdateStatements, and ShadowContentResolver.DeleteStatements invoked on this ContentResolver.
static ShadowContentResolver.Status	getStatus(android.accounts.Account account, java.lang.String authority)
static ShadowContentResolver.Status	getStatus(android.accounts.Account account, java.lang.String authority, boolean create) Retrieve information on the status of the given account.
static boolean	getSyncAutomatically(android.accounts.Account account, java.lang.String authority)
java.lang.String	getType(android.net.Uri uri)
java.util.List<ShadowContentResolver.UpdateStatement>	getUpdateStatements() Returns the list of ShadowContentResolver.UpdateStatements for corresponding calls to ContentResolver.update(Uri, ContentValues, String, String[]).
android.net.Uri	insert(android.net.Uri url, android.content.ContentValues values) If a ContentProvider is registered for the given Uri, its ContentProvider.insert(Uri, ContentValues) method will be invoked.
static boolean	isSyncActive(android.accounts.Account account, java.lang.String authority)
void	notifyChange(android.net.Uri uri, android.database.ContentObserver observer)
void	notifyChange(android.net.Uri uri, android.database.ContentObserver observer, boolean syncToNetwork)
java.io.InputStream	openInputStream(android.net.Uri uri)
java.io.OutputStream	openOutputStream(android.net.Uri uri)
android.database.Cursor	query(android.net.Uri uri, java.lang.String[] projection, java.lang.String selection, java.lang.String[] selectionArgs, java.lang.String sortOrder)
android.database.Cursor	query(android.net.Uri uri, java.lang.String[] projection, java.lang.String selection, java.lang.String[] selectionArgs, java.lang.String sortOrder, android.os.CancellationSignal cancellationSignal)
void	registerContentObserver(android.net.Uri uri, boolean notifyForDescendents, android.database.ContentObserver observer)
void	registerContentObserver(android.net.Uri uri, boolean notifyForDescendents, android.database.ContentObserver observer, int userHandle)
void	registerInputStream(android.net.Uri uri, java.io.InputStream inputStream)
static void	registerProviderInternal(java.lang.String authority, android.content.ContentProvider provider) Internal-only method, do not use!
void	releasePersistableUriPermission(android.net.Uri uri, int modeFlags)
static void	removePeriodicSync(android.accounts.Account account, java.lang.String authority, android.os.Bundle extras)
static void	requestSync(android.accounts.Account account, java.lang.String authority, android.os.Bundle extras)
static void	reset()
void	setContentProviderResult(android.content.ContentProviderResult[] contentProviderResults)
void	setCursor(BaseCursor cursor)
void	setCursor(android.net.Uri uri, BaseCursor cursorForUri)
static void	setIsSyncable(android.accounts.Account account, java.lang.String authority, int syncable)
static void	setMasterSyncAutomatically(boolean sync)
void	setNextDatabaseIdForInserts(int nextId)
void	setNextDatabaseIdForUpdates(int nextId) Deprecated. This method will be removed in Robolectric 3.5. Instead, 1 will be returned.
static void	setSyncAutomatically(android.accounts.Account account, java.lang.String authority, boolean sync)
void	takePersistableUriPermission(android.net.Uri uri, int modeFlags)
void	unregisterContentObserver(android.database.ContentObserver observer)
int	update(android.net.Uri uri, android.content.ContentValues values, java.lang.String where, java.lang.String[] selectionArgs) If a ContentProvider is registered for the given Uri, its ContentProvider.update(Uri, ContentValues, String, String[]) method will be invoked.
static void	validateSyncExtrasBundle(android.os.Bundle extras)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ShadowContentResolver

public ShadowContentResolver()

Method Detail

reset

@Resetter
public static void reset()

registerInputStream

public void registerInputStream(android.net.Uri uri,
                                java.io.InputStream inputStream)

openInputStream

@Implementation
public final java.io.InputStream openInputStream(android.net.Uri uri)

openOutputStream

@Implementation
public final java.io.OutputStream openOutputStream(android.net.Uri uri)

insert

@Implementation
public final android.net.Uri insert(android.net.Uri url,
                                                    android.content.ContentValues values)

If a ContentProvider is registered for the given Uri, its ContentProvider.insert(Uri, ContentValues) method will be invoked.

Tests can verify that this method was called using getStatements() or getInsertStatements().

If no appropriate ContentProvider is found, no action will be taken and a Uri including the incremented value set with setNextDatabaseIdForInserts(int) will returned.

update

@Implementation
public int update(android.net.Uri uri,
                                  android.content.ContentValues values,
                                  java.lang.String where,
                                  java.lang.String[] selectionArgs)

If a ContentProvider is registered for the given Uri, its ContentProvider.update(Uri, ContentValues, String, String[]) method will be invoked.

Tests can verify that this method was called using getStatements() or getUpdateStatements().

If no appropriate ContentProvider is found, no action will be taken and the value set with setNextDatabaseIdForUpdates(int) will be incremented and returned.

Note: the return value in this case will be changed to 1 in a future release of Robolectric.

query

@Implementation
public final android.database.Cursor query(android.net.Uri uri,
                                                           java.lang.String[] projection,
                                                           java.lang.String selection,
                                                           java.lang.String[] selectionArgs,
                                                           java.lang.String sortOrder)

query

@Implementation
public android.database.Cursor query(android.net.Uri uri,
                                                     java.lang.String[] projection,
                                                     java.lang.String selection,
                                                     java.lang.String[] selectionArgs,
                                                     java.lang.String sortOrder,
                                                     android.os.CancellationSignal cancellationSignal)

getType

@Implementation
public java.lang.String getType(android.net.Uri uri)

call

@Implementation
public android.os.Bundle call(android.net.Uri uri,
                                              java.lang.String method,
                                              java.lang.String arg,
                                              android.os.Bundle extras)

acquireContentProviderClient

@Implementation
public final android.content.ContentProviderClient acquireContentProviderClient(java.lang.String name)

acquireContentProviderClient

@Implementation
public final android.content.ContentProviderClient acquireContentProviderClient(android.net.Uri uri)

acquireUnstableContentProviderClient

@Implementation
public final android.content.ContentProviderClient acquireUnstableContentProviderClient(java.lang.String name)

acquireUnstableContentProviderClient

@Implementation
public final android.content.ContentProviderClient acquireUnstableContentProviderClient(android.net.Uri uri)

acquireProvider

@Implementation
public final android.content.IContentProvider acquireProvider(java.lang.String name)

acquireProvider

@Implementation
public final android.content.IContentProvider acquireProvider(android.net.Uri uri)

acquireUnstableProvider

@Implementation
public final android.content.IContentProvider acquireUnstableProvider(java.lang.String name)

acquireUnstableProvider

@Implementation
public final android.content.IContentProvider acquireUnstableProvider(android.net.Uri uri)

delete

@Implementation
public final int delete(android.net.Uri url,
                                        java.lang.String where,
                                        java.lang.String[] selectionArgs)

If a ContentProvider is registered for the given Uri, its ContentProvider.delete(Uri, String, String[]) method will be invoked.

Tests can verify that this method was called using getDeleteStatements() or getDeletedUris().

If no appropriate ContentProvider is found, no action will be taken and 1 will be returned.

bulkInsert

@Implementation
public final int bulkInsert(android.net.Uri url,
                                            android.content.ContentValues[] values)

If a ContentProvider is registered for the given Uri, its ContentProvider.bulkInsert(Uri, ContentValues[]) method will be invoked.

Tests can verify that this method was called using getStatements() or getInsertStatements().

If no appropriate ContentProvider is found, no action will be taken and the number of rows in values will be returned.

notifyChange

@Implementation
public void notifyChange(android.net.Uri uri,
                                         android.database.ContentObserver observer,
                                         boolean syncToNetwork)

notifyChange

@Implementation
public void notifyChange(android.net.Uri uri,
                                         android.database.ContentObserver observer)

applyBatch

@Implementation
public android.content.ContentProviderResult[] applyBatch(java.lang.String authority,
                                                                          java.util.ArrayList<android.content.ContentProviderOperation> operations)
                                                                   throws android.content.OperationApplicationException

Throws:

android.content.OperationApplicationException

requestSync

@Implementation
public static void requestSync(android.accounts.Account account,
                                               java.lang.String authority,
                                               android.os.Bundle extras)

cancelSync

@Implementation
public static void cancelSync(android.accounts.Account account,
                                              java.lang.String authority)

isSyncActive

@Implementation
public static boolean isSyncActive(android.accounts.Account account,
                                                   java.lang.String authority)

setIsSyncable

@Implementation
public static void setIsSyncable(android.accounts.Account account,
                                                 java.lang.String authority,
                                                 int syncable)

getIsSyncable

@Implementation
public static int getIsSyncable(android.accounts.Account account,
                                                java.lang.String authority)

getSyncAutomatically

@Implementation
public static boolean getSyncAutomatically(android.accounts.Account account,
                                                           java.lang.String authority)

setSyncAutomatically

@Implementation
public static void setSyncAutomatically(android.accounts.Account account,
                                                        java.lang.String authority,
                                                        boolean sync)

addPeriodicSync

@Implementation
public static void addPeriodicSync(android.accounts.Account account,
                                                   java.lang.String authority,
                                                   android.os.Bundle extras,
                                                   long pollFrequency)

removePeriodicSync

@Implementation
public static void removePeriodicSync(android.accounts.Account account,
                                                      java.lang.String authority,
                                                      android.os.Bundle extras)

getPeriodicSyncs

@Implementation
public static java.util.List<android.content.PeriodicSync> getPeriodicSyncs(android.accounts.Account account,
                                                                                            java.lang.String authority)

validateSyncExtrasBundle

@Implementation
public static void validateSyncExtrasBundle(android.os.Bundle extras)

setMasterSyncAutomatically

@Implementation
public static void setMasterSyncAutomatically(boolean sync)

getMasterSyncAutomatically

@Implementation
public static boolean getMasterSyncAutomatically()

takePersistableUriPermission

@Implementation(minSdk=19)
public void takePersistableUriPermission(android.net.Uri uri,
                                                                    int modeFlags)

releasePersistableUriPermission

@Implementation(minSdk=19)
public void releasePersistableUriPermission(android.net.Uri uri,
                                                                       int modeFlags)

getPersistedUriPermissions

@Implementation(minSdk=19)
public java.util.List<android.content.UriPermission> getPersistedUriPermissions()

getProvider

public static android.content.ContentProvider getProvider(android.net.Uri uri)

registerProviderInternal

public static void registerProviderInternal(java.lang.String authority,
                                            android.content.ContentProvider provider)

Internal-only method, do not use!

Instead, use

ProviderInfo info = new ProviderInfo();
info.authority = authority;
Robolectric.buildContentProvider(ContentProvider.class).create(info);

getStatus

public static ShadowContentResolver.Status getStatus(android.accounts.Account account,
                                                     java.lang.String authority)

getStatus

public static ShadowContentResolver.Status getStatus(android.accounts.Account account,
                                                     java.lang.String authority,
                                                     boolean create)

Retrieve information on the status of the given account.

Parameters:

account - the account

authority - the authority

create - whether to create if no such account is found

Returns:

the account’s status

setCursor

public void setCursor(BaseCursor cursor)

setCursor

public void setCursor(android.net.Uri uri,
                      BaseCursor cursorForUri)

setNextDatabaseIdForInserts

public void setNextDatabaseIdForInserts(int nextId)

setNextDatabaseIdForUpdates

@Deprecated
public void setNextDatabaseIdForUpdates(int nextId)

Deprecated. This method will be removed in Robolectric 3.5. Instead, 1 will be returned.

Set the value to be returned by ContentResolver.update(Uri, ContentValues, String, String[]) when no appropriate ContentProvider can be found.

Parameters:

nextId - the number of rows to return

getStatements

public java.util.List<ShadowContentResolver.Statement> getStatements()

Returns the list of ShadowContentResolver.InsertStatements, ShadowContentResolver.UpdateStatements, and ShadowContentResolver.DeleteStatements invoked on this ContentResolver.

Returns:

a list of statements

getInsertStatements

public java.util.List<ShadowContentResolver.InsertStatement> getInsertStatements()

Returns the list of ShadowContentResolver.InsertStatements for corresponding calls to ContentResolver.insert(Uri, ContentValues) or ContentResolver.bulkInsert(Uri, ContentValues[]).

Returns:

a list of insert statements

getUpdateStatements

public java.util.List<ShadowContentResolver.UpdateStatement> getUpdateStatements()

Returns the list of ShadowContentResolver.UpdateStatements for corresponding calls to ContentResolver.update(Uri, ContentValues, String, String[]).

Returns:

a list of update statements

getDeletedUris

public java.util.List<android.net.Uri> getDeletedUris()

getDeleteStatements

public java.util.List<ShadowContentResolver.DeleteStatement> getDeleteStatements()

Returns the list of ShadowContentResolver.DeleteStatements for corresponding calls to ContentResolver.delete(Uri, String, String[]).

Returns:

a list of delete statements

getNotifiedUris

public java.util.List<ShadowContentResolver.NotifiedUri> getNotifiedUris()

getContentProviderOperations

public java.util.List<android.content.ContentProviderOperation> getContentProviderOperations(java.lang.String authority)

setContentProviderResult

public void setContentProviderResult(android.content.ContentProviderResult[] contentProviderResults)

registerContentObserver

@Implementation
public void registerContentObserver(android.net.Uri uri,
                                                    boolean notifyForDescendents,
                                                    android.database.ContentObserver observer)

registerContentObserver

@Implementation
public void registerContentObserver(android.net.Uri uri,
                                                    boolean notifyForDescendents,
                                                    android.database.ContentObserver observer,
                                                    int userHandle)

unregisterContentObserver

@Implementation
public void unregisterContentObserver(android.database.ContentObserver observer)

clearContentObservers

@Deprecated
public void clearContentObservers()

Deprecated. Do not use this method.

getContentObservers

public java.util.Collection<android.database.ContentObserver> getContentObservers(android.net.Uri uri)

Returns the content observers registered for updates under the given URI.

Will be empty if no observer is registered.

Parameters:

uri - Given URI

Returns:

The content observers, or null