public class

ContentProviderClient

extends Object
java.lang.Object
   ↳ android.content.ContentProviderClient

Class Overview

The public interface object used to interact with a ContentProvider. This is obtained by calling acquireContentProviderClient(Uri). This object must be released using release() in order to indicate to the system that the ContentProvider is no longer needed and can be killed to free up resources.

Summary

Public Methods
ContentProviderResult[] applyBatch(ArrayList<ContentProviderOperation> operations)
see applyBatch(ArrayList)
int bulkInsert(Uri url, ContentValues[] initialValues)
see bulkInsert(Uri, ContentValues[])
int delete(Uri url, String selection, String[] selectionArgs)
see delete(Uri, String, String[])
ContentProvider getLocalContentProvider()
Get a reference to the ContentProvider that is associated with this client.
String getType(Uri url)
see getType(Uri)
Uri insert(Uri url, ContentValues initialValues)
see insert(Uri, ContentValues)
AssetFileDescriptor openAssetFile(Uri url, String mode)
see openAssetFile(Uri, String)
ParcelFileDescriptor openFile(Uri url, String mode)
see openFile(Uri, String)
Cursor query(Uri url, String[] projection, String selection, String[] selectionArgs, String sortOrder)
see query(Uri, String[], String, String[], String)
boolean release()
Call this to indicate to the system that the associated ContentProvider is no longer needed by this ContentProviderClient.
int update(Uri url, ContentValues values, String selection, String[] selectionArgs)
see update(Uri, ContentValues, String, String[])
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public ContentProviderResult[] applyBatch (ArrayList<ContentProviderOperation> operations)

Since: API Level 5

see applyBatch(ArrayList)

Throws
RemoteException
OperationApplicationException

public int bulkInsert (Uri url, ContentValues[] initialValues)

Since: API Level 5

see bulkInsert(Uri, ContentValues[])

Throws
RemoteException

public int delete (Uri url, String selection, String[] selectionArgs)

Since: API Level 5

see delete(Uri, String, String[])

Throws
RemoteException

public ContentProvider getLocalContentProvider ()

Since: API Level 5

Get a reference to the ContentProvider that is associated with this client. If the ContentProvider is running in a different process then null will be returned. This can be used if you know you are running in the same process as a provider, and want to get direct access to its implementation details.

Returns
  • If the associated ContentProvider is local, returns it. Otherwise returns null.

public String getType (Uri url)

Since: API Level 5

see getType(Uri)

Throws
RemoteException

public Uri insert (Uri url, ContentValues initialValues)

Since: API Level 5

see insert(Uri, ContentValues)

Throws
RemoteException

public AssetFileDescriptor openAssetFile (Uri url, String mode)

Since: API Level 5

see openAssetFile(Uri, String)

Throws
RemoteException
FileNotFoundException

public ParcelFileDescriptor openFile (Uri url, String mode)

Since: API Level 5

see openFile(Uri, String)

Throws
RemoteException
FileNotFoundException

public Cursor query (Uri url, String[] projection, String selection, String[] selectionArgs, String sortOrder)

Since: API Level 5

see query(Uri, String[], String, String[], String)

Throws
RemoteException

public boolean release ()

Since: API Level 5

Call this to indicate to the system that the associated ContentProvider is no longer needed by this ContentProviderClient.

Returns
  • true if this was release, false if it was already released

public int update (Uri url, ContentValues values, String selection, String[] selectionArgs)

Since: API Level 5

see update(Uri, ContentValues, String, String[])

Throws
RemoteException