| java.lang.Object | |
| ↳ | android.os.DropBoxManager |
Enqueues chunks of data (from various sources -- application crashes, kernel log records, etc.). The queue is size bounded and will drop old data if the enqueued data exceeds the maximum size. You can think of this as a persistent, system-wide, blob-oriented "logcat".
You can obtain an instance of this class by calling
getSystemService(String)
with DROPBOX_SERVICE.
DropBoxManager entries are not sent anywhere directly, but other system services and debugging tools may scan and upload entries for processing.
| Nested Classes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| DropBoxManager.Entry | A single entry retrieved from the drop box. | ||||||||||
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | ACTION_DROPBOX_ENTRY_ADDED | Broadcast Action: This is broadcast when a new entry is added in the dropbox. | |||||||||
| String | EXTRA_TAG | Extra for ACTION_DROPBOX_ENTRY_ADDED:
string containing the dropbox tag. |
|||||||||
| String | EXTRA_TIME | Extra for ACTION_DROPBOX_ENTRY_ADDED:
long integer value containing time (in milliseconds since January 1, 1970 00:00:00 UTC)
when the entry was created. |
|||||||||
| int | IS_EMPTY | Flag value: Entry's content was deleted to save space. | |||||||||
| int | IS_GZIPPED | Flag value: Content can be decompressed with GZIPOutputStream. |
|||||||||
| int | IS_TEXT | Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED). | |||||||||
| Protected Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Create a dummy instance for testing.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Stores binary data, which may be ignored or discarded as with
addText(String, String). | |||||||||||
Stores the contents of a file, which may be ignored or discarded as with
addText(String, String). | |||||||||||
Stores human-readable text.
| |||||||||||
Gets the next entry from the drop box after the specified time.
| |||||||||||
Checks any blacklists (set in system settings) to see whether a certain
tag is allowed.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Broadcast Action: This is broadcast when a new entry is added in the dropbox.
You must hold the READ_LOGS permission
in order to receive this broadcast.
This is a protected intent that can only be sent by the system.
Extra for ACTION_DROPBOX_ENTRY_ADDED:
string containing the dropbox tag.
Extra for ACTION_DROPBOX_ENTRY_ADDED:
long integer value containing time (in milliseconds since January 1, 1970 00:00:00 UTC)
when the entry was created.
Flag value: Entry's content was deleted to save space.
Flag value: Content can be decompressed with GZIPOutputStream.
Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED).
Create a dummy instance for testing. All methods will fail unless
overridden with an appropriate mock implementation. To obtain a
functional instance, use getSystemService(String).
Stores binary data, which may be ignored or discarded as with addText(String, String).
| tag | describing the type of entry being stored |
|---|---|
| data | value to store |
| flags | describing the data |
Stores the contents of a file, which may be ignored or discarded as with
addText(String, String).
| tag | describing the type of entry being stored |
|---|---|
| file | to read from |
| flags | describing the data |
| IOException | if the file can't be opened |
|---|
Stores human-readable text. The data may be discarded eventually (or even
immediately) if space is limited, or ignored entirely if the tag has been
blocked (see isTagEnabled(String)).
| tag | describing the type of entry being stored |
|---|---|
| data | value to store |
Gets the next entry from the drop box after the specified time.
Requires android.permission.READ_LOGS. You must always call
close() on the return value!
| tag | of entry to look for, null for all tags |
|---|---|
| msec | time of the last entry seen |
Checks any blacklists (set in system settings) to see whether a certain tag is allowed. Entries with disabled tags will be dropped immediately, so you can save the work of actually constructing and sending the data.
| tag | that would be used in addText(String, String) or addFile(String, File, int) |
|---|