IT. Expert System.

public class DropBoxManager
extends Object

• Nested Class Summary

  Nested Classes

  Modifier and Type	Class and Description
  static class	DropBoxManager.Entry A single entry retrieved from the drop box.

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static String	ACTION_DROPBOX_ENTRY_ADDED Broadcast Action: This is broadcast when a new entry is added in the dropbox.
  static String	EXTRA_TAG Extra for ACTION_DROPBOX_ENTRY_ADDED: string containing the dropbox tag.
  static 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.
  static int	IS_EMPTY Flag value: Entry's content was deleted to save space.
  static int	IS_GZIPPED Flag value: Content can be decompressed with GZIPOutputStream.
  static int	IS_TEXT Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED).

• Constructor Summary

  Constructors

  Modifier	Constructor and Description
  protected	DropBoxManager() Create a dummy instance for testing.
  	DropBoxManager(IDropBoxManagerService service)

• Method Summary

  Methods

  Modifier and Type	Method and Description
  void	addData(String tag, byte[] data, int flags) Stores binary data, which may be ignored or discarded as with addText(java.lang.String, java.lang.String).
  void	addFile(String tag, File file, int flags) Stores the contents of a file, which may be ignored or discarded as with addText(java.lang.String, java.lang.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.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • IS_EMPTY

    public static final int IS_EMPTY

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

    See Also:

    Constant Field Values

  • IS_TEXT

    public static final int IS_TEXT

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

    See Also:

    Constant Field Values

  • IS_GZIPPED

    public static final int IS_GZIPPED

    Flag value: Content can be decompressed with GZIPOutputStream.

    See Also:

    Constant Field Values

  • 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 android.Manifest.permission#READ_LOGS permission in order to receive this broadcast.

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

    See Also:

    Constant Field Values

  • EXTRA_TAG

    public static final String EXTRA_TAG

    Extra for ACTION_DROPBOX_ENTRY_ADDED: string containing the dropbox tag.

    See Also:

    Constant Field Values

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

    See Also:

    Constant Field Values

• Constructor Detail

  • DropBoxManager

    public DropBoxManager(IDropBoxManagerService service)

  • 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(java.lang.String).

• Method Detail

  • 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(java.lang.String)).

    Parameters:

    tag - describing the type of entry being stored

    data - value to store

  • addData

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

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

    Parameters:

    tag - describing the type of entry being stored

    data - value to store

    flags - describing the data

  • addFile

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

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

    Parameters:

    tag - describing the type of entry being stored

    file - to read from

    flags - describing the data

    Throws:

    IOException - if the file can't be opened

  • 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 - that would be used in addText(java.lang.String, java.lang.String) or addFile(java.lang.String, java.io.File, int)

    Returns:

    whether events with that tag would be accepted

  • getNextEntry

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

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

    Parameters:

    tag - of entry to look for, null for all tags

    msec - time of the last entry seen

    Returns:

    the next entry, or null if there are no more entries