Most visited

Recently visited

Results for

Summary: Nested Classes | Constants | Protected Ctors | Methods | Inherited Methods

DropBoxManager

public class DropBoxManager
extends Object

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".

DropBoxManager entries are not sent anywhere directly, but other system services and debugging tools may scan and upload entries for processing.

Summary

Nested classes
`class`	`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_DROPPED_COUNT` Extra for `ACTION_DROPBOX_ENTRY_ADDED`: integer value containing number of broadcasts dropped due to rate limiting on this `EXTRA_TAG`
`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
`DropBoxManager()` Create a dummy instance for testing.

Public methods
`void`	`addData(String tag, byte[] data, int flags)` Stores binary data, which may be ignored or discarded as with `addText(String, String)`.
`void`	`addFile(String tag, File file, int flags)` Stores the contents of a file, which may be ignored or discarded as with `addText(String, String)`.
`void`	`addText(String tag, String data)` Stores human-readable text.
`DropBoxManager.Entry`	`getNextEntry(String tag, long msec)` Gets the next entry from the drop box after the specified time.
`boolean`	`isTagEnabled(String tag)` Checks any blacklists (set in system settings) to see whether a certain tag is allowed.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Constants

ACTION_DROPBOX_ENTRY_ADDED

public static final String ACTION_DROPBOX_ENTRY_ADDED

Broadcast Action: This is broadcast when a new entry is added in the dropbox. You must hold the Manifest.permission.READ_LOGS permission in order to receive this broadcast. This broadcast can be rate limited for low priority entries

This is a protected intent that can only be sent by the system.

Constant Value: "android.intent.action.DROPBOX_ENTRY_ADDED"

EXTRA_DROPPED_COUNT

public static final String EXTRA_DROPPED_COUNT

Extra for ACTION_DROPBOX_ENTRY_ADDED: integer value containing number of broadcasts dropped due to rate limiting on this EXTRA_TAG

Constant Value: "android.os.extra.DROPPED_COUNT"

EXTRA_TAG

public static final String EXTRA_TAG

Extra for ACTION_DROPBOX_ENTRY_ADDED: string containing the dropbox tag.

Constant Value: "tag"

EXTRA_TIME

public static final 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.

Constant Value: "time"

IS_EMPTY

public static final int IS_EMPTY

Flag value: Entry's content was deleted to save space.

Constant Value: 1 (0x00000001)

IS_GZIPPED

public static final int IS_GZIPPED

Flag value: Content can be decompressed with GZIPOutputStream.

Constant Value: 4 (0x00000004)

IS_TEXT

public static final int IS_TEXT

Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED).

Constant Value: 2 (0x00000002)

Protected constructors

DropBoxManager

protected DropBoxManager ()

Create a dummy instance for testing. All methods will fail unless overridden with an appropriate mock implementation. To obtain a functional instance, use Context.getSystemService(Class).

Public methods

addData

public void addData (String tag, 
                byte[] data, 
                int flags)

Stores binary data, which may be ignored or discarded as with addText(String, String).

Parameters
`tag`	`String`: describing the type of entry being stored
`data`	`byte`: value to store
`flags`	`int`: describing the data

addFile

public void addFile (String tag, 
                File file, 
                int flags)

Stores the contents of a file, which may be ignored or discarded as with addText(String, String).

Parameters
`tag`	`String`: describing the type of entry being stored
`file`	`File`: to read from
`flags`	`int`: describing the data

Throws
`IOException`	if the file can't be opened

addText

public void addText (String tag, 
                String data)

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

Parameters
`tag`	`String`: describing the type of entry being stored
`data`	`String`: value to store

getNextEntry

public DropBoxManager.Entry getNextEntry (String tag, 
                long msec)

Gets the next entry from the drop box after the specified time. You must always call Entry#close() on the return value!
Requires Manifest.permission.READ_LOGS and Manifest.permission.PACKAGE_USAGE_STATS

Parameters
`tag`	`String`: of entry to look for, null for all tags
`msec`	`long`: time of the last entry seen

Returns
`DropBoxManager.Entry`	the next entry, or null if there are no more entries

isTagEnabled

public boolean isTagEnabled (String tag)

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.

Parameters
`tag`	`String`: that would be used in `addText(String, String)` or `addFile(String, File, int)`

Returns
`boolean`	whether events with that tag would be accepted

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

DropBoxManager

Summary

Nested classes

Constants

Protected constructors

Public methods

Inherited methods

Constants

ACTION_DROPBOX_ENTRY_ADDED

EXTRA_DROPPED_COUNT

EXTRA_TAG

EXTRA_TIME

IS_EMPTY

IS_GZIPPED

IS_TEXT

Protected constructors

DropBoxManager

Public methods

addData

addFile

addText

getNextEntry

isTagEnabled