public class DumpHeapProvider extends ContentProvider
ContentProvider.PipeDataWriter<T>
TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN
Constructor and Description |
---|
DumpHeapProvider() |
Modifier and Type | Method and Description |
---|---|
int |
delete(Uri uri,
String selection,
String[] selectionArgs)
Implement this to handle requests to delete one or more rows.
|
static File |
getJavaFile() |
String |
getType(Uri uri)
Implement this to handle requests for the MIME type of the data at the
given URI.
|
Uri |
insert(Uri uri,
ContentValues values)
Implement this to handle requests to insert a new row.
|
boolean |
onCreate()
Implement this to initialize your content provider on startup.
|
ParcelFileDescriptor |
openFile(Uri uri,
String mode)
Override this to handle requests to open a file blob.
|
Cursor |
query(Uri uri,
String[] projection,
String selection,
String[] selectionArgs,
String sortOrder)
Implement this to handle query requests from clients.
|
int |
update(Uri uri,
ContentValues values,
String selection,
String[] selectionArgs)
Implement this to handle requests to update one or more rows.
|
applyBatch, attachInfo, attachInfoForTesting, bulkInsert, call, canonicalize, coerceToLocalContentProvider, dump, enforceReadPermissionInner, enforceWritePermissionInner, getAppOpsManager, getAuthorityWithoutUserId, getCallingPackage, getContext, getIContentProvider, getPathPermissions, getReadPermission, getStreamTypes, getUriWithoutUserId, getUserIdFromAuthority, getUserIdFromAuthority, getUserIdFromUri, getUserIdFromUri, getWritePermission, isTemporary, matchesOurAuthorities, maybeAddUserId, onConfigurationChanged, onLowMemory, onTrimMemory, openAssetFile, openAssetFile, openFile, openFileHelper, openPipeHelper, openTypedAssetFile, openTypedAssetFile, query, rejectInsert, setAppOps, setAuthorities, setPathPermissions, setReadPermission, setWritePermission, shutdown, uncanonicalize, uriHasUserId
public static File getJavaFile()
public boolean onCreate()
ContentProvider
You should defer nontrivial initialization (such as opening,
upgrading, and scanning databases) until the content provider is used
(via ContentProvider.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String)
, ContentProvider.insert(android.net.Uri, android.content.ContentValues)
, etc). Deferred initialization
keeps application startup fast, avoids unnecessary work if the provider
turns out not to be needed, and stops database errors (such as a full
disk) from halting application launch.
If you use SQLite, SQLiteOpenHelper
is a helpful utility class that makes it easy to manage databases,
and will automatically defer opening until first use. If you do use
SQLiteOpenHelper, make sure to avoid calling
SQLiteOpenHelper.getReadableDatabase()
or
SQLiteOpenHelper.getWritableDatabase()
from this method. (Instead, override
SQLiteOpenHelper.onOpen(android.database.sqlite.SQLiteDatabase)
to initialize the
database when it is first opened.)
onCreate
in class ContentProvider
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)
ContentProvider
Example client call:
// Request a specific record. Cursor managedCursor = managedQuery( ContentUris.withAppendedId(Contacts.People.CONTENT_URI, 2), projection, // Which columns to return. null, // WHERE clause. null, // WHERE clause value substitution People.NAME + " ASC"); // Sort order.Example implementation:
// SQLiteQueryBuilder is a helper class that creates the // proper SQL syntax for us. SQLiteQueryBuilder qBuilder = new SQLiteQueryBuilder(); // Set the table we're querying. qBuilder.setTables(DATABASE_TABLE_NAME); // If the query ends in a specific record number, we're // being asked for a specific record, so set the // WHERE clause in our query. if((URI_MATCHER.match(uri)) == SPECIFIC_MESSAGE){ qBuilder.appendWhere("_id=" + uri.getPathLeafId()); } // Make the query. Cursor c = qBuilder.query(mDb, projection, selection, selectionArgs, groupBy, having, sortOrder); c.setNotificationUri(getContext().getContentResolver(), uri); return c;
query
in class ContentProvider
uri
- The URI to query. This will be the full URI sent by the client;
if the client is requesting a specific record, the URI will end in a record number
that the implementation should parse and add to a WHERE or HAVING clause, specifying
that _id value.projection
- The list of columns to put into the cursor. If
null
all columns are included.selection
- A selection criteria to apply when filtering rows.
If null
then all rows are included.selectionArgs
- You may include ?s in selection, which will be replaced by
the values from selectionArgs, in order that they appear in the selection.
The values will be bound as Strings.sortOrder
- How the rows in the cursor should be sorted.
If null
then the provider is free to define the sort order.null
.public String getType(Uri uri)
ContentProvider
vnd.android.cursor.item
for a single record,
or vnd.android.cursor.dir/
for multiple items.
This method can be called from multiple threads, as described in
Processes
and Threads.
Note that there are no permissions needed for an application to access this information; if your content provider requires read and/or write permissions, or is not exported, all applications can still call this method regardless of their access permissions. This allows them to retrieve the MIME type for a URI when dispatching intents.
getType
in class ContentProvider
uri
- the URI to query.null
if there is no type.public Uri insert(Uri uri, ContentValues values)
ContentProvider
notifyChange()
after inserting.
This method can be called from multiple threads, as described in
Processes
and Threads.insert
in class ContentProvider
uri
- The content:// URI of the insertion request. This must not be null
.values
- A set of column_name/value pairs to add to the database.
This must not be null
.public int delete(Uri uri, String selection, String[] selectionArgs)
ContentProvider
notifyChange()
after deleting.
This method can be called from multiple threads, as described in
Processes
and Threads.
The implementation is responsible for parsing out a row ID at the end
of the URI, if a specific row is being deleted. That is, the client would
pass in content://contacts/people/22
and the implementation is
responsible for parsing the record number (22) when creating a SQL statement.
delete
in class ContentProvider
uri
- The full URI to query, including a row ID (if a specific record is requested).selection
- An optional restriction to apply to rows when deleting.public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)
ContentProvider
notifyChange()
after updating.
This method can be called from multiple threads, as described in
Processes
and Threads.update
in class ContentProvider
uri
- The URI to query. This can potentially have a record ID if this
is an update request for a specific record.values
- A set of column_name/value pairs to update in the database.
This must not be null
.selection
- An optional filter to match rows to update.public ParcelFileDescriptor openFile(Uri uri, String mode) throws FileNotFoundException
ContentProvider
FileNotFoundException
.
This method can be called from multiple threads, as described in
Processes
and Threads.
This method returns a ParcelFileDescriptor, which is returned directly to the caller. This way large data (such as images and documents) can be returned without copying the content.
The returned ParcelFileDescriptor is owned by the caller, so it is their responsibility to close it when done. That is, the implementation of this method should create a new ParcelFileDescriptor for each call.
If opened with the exclusive "r" or "w" modes, the returned ParcelFileDescriptor can be a pipe or socket pair to enable streaming of data. Opening with the "rw" or "rwt" modes implies a file on disk that supports seeking.
If you need to detect when the returned ParcelFileDescriptor has been
closed, or if the remote process has crashed or encountered some other
error, you can use ParcelFileDescriptor.open(File, int,
android.os.Handler, android.os.ParcelFileDescriptor.OnCloseListener)
,
ParcelFileDescriptor.createReliablePipe()
, or
ParcelFileDescriptor.createReliableSocketPair()
.
For use in Intents, you will want to implement ContentProvider.getType(android.net.Uri)
to return the appropriate MIME type for the data returned here with
the same URI. This will allow intent resolution to automatically determine the data MIME
type and select the appropriate matching targets as part of its operation.
For better interoperability with other applications, it is recommended
that for any URIs that can be opened, you also support queries on them
containing at least the columns specified by OpenableColumns
.
You may also want to support other common columns if you have additional meta-data
to supply, such as MediaStore.MediaColumns.DATE_ADDED
in MediaStore.MediaColumns
.
openFile
in class ContentProvider
uri
- The URI whose file is to be opened.mode
- Access mode for the file. May be "r" for read-only access,
"rw" for read and write access, or "rwt" for read and write access
that truncates any existing file.FileNotFoundException
- Throws FileNotFoundException if there is
no file associated with the given URI or the mode is invalid.ContentProvider.openAssetFile(Uri, String)
,
ContentProvider.openFileHelper(Uri, String)
,
ContentProvider.getType(android.net.Uri)
,
ParcelFileDescriptor.parseMode(String)