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) |
---|