net.rim.device.api.memorycleaner
Class MemoryCleanerDaemon

java.lang.Object
  extended by net.rim.device.api.memorycleaner.MemoryCleanerDaemon

public final class MemoryCleanerDaemon
extends Object

Allows security-sensitive applications to register listeners for cleaning sensitive information upon various device events.

The events responded to are in accordance with the settings specified in the security options for the MemoryCleaner application (such as being placed in the holster, or being idle for some amount of time).

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

Method Summary
Category: Signed static void addListener(MemoryCleanerListener listener)
          Registers a listener with this daemon, and start the memory cleaner daemon (if it is not already running).
Category: Signed static void addListener(MemoryCleanerListener listener, boolean enable)
          Registers a listener with this daemon, and optionally start the memory cleaner daemon (if it is not already running).
Category: Signed static void addWeakListener(MemoryCleanerListener listener)
          Registers a weak reference for a listener with this daemon, and start the memory cleaner daemon (if it is not already running).
Category: Signed static void addWeakListener(MemoryCleanerListener listener, boolean enable)
          Registers a weak reference for a listener with this daemon, and optionally start the memory cleaner daemon (if it is not already running).
Category: Signed static void cleanAll()
          Starts a programmatic clean of the registered memory cleaner listeners.
Category: Signed static void removeListener(MemoryCleanerListener listener)
          Removes provided listener from this daemon's registry.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 



Method Detail

addListener

public static void addListener(MemoryCleanerListener listener)
Registers a listener with this daemon, and start the memory cleaner daemon (if it is not already running).

This method registers a strong reference to your provided listener so that it will not be garbage-collected.

Parameters:
listener - Listener to notify on events that should trigger a clean.
See Also:
MemoryCleanerDaemon.removeListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

addListener

public static void addListener(MemoryCleanerListener listener,
                               boolean enable)
Registers a listener with this daemon, and optionally start the memory cleaner daemon (if it is not already running).

This method registers a strong reference to your provided listener so that it will not be garbage-collected.

Parameters:
listener - Listener to notify on events that should trigger a clean.
enable - if true, then start the memory cleaner daemon, otherwise wait for something else to start it.
See Also:
MemoryCleanerDaemon.removeListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.2

addWeakListener

public static void addWeakListener(MemoryCleanerListener listener)
Registers a weak reference for a listener with this daemon, and start the memory cleaner daemon (if it is not already running).

This method registers only a weak reference to your provided listener; thus, you must save a reference to the listener to prevent it from being garbage collected.

Parameters:
listener - Listener to notify on events that should trigger a clean.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

addWeakListener

public static void addWeakListener(MemoryCleanerListener listener,
                                   boolean enable)
Registers a weak reference for a listener with this daemon, and optionally start the memory cleaner daemon (if it is not already running).

This method registers only a weak reference to your provided listener; thus, you must save a reference to the listener to prevent it from being garbage collected.

Parameters:
listener - Listener to notify on events that should trigger a clean.
enable - if true, then start the memory cleaner daemon, otherwise wait for something else to start it.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.2

removeListener

public static void removeListener(MemoryCleanerListener listener)
Removes provided listener from this daemon's registry.

Parameters:
listener - Listener to remove.
See Also:
MemoryCleanerDaemon.addListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

cleanAll

public static void cleanAll()
Starts a programmatic clean of the registered memory cleaner listeners.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.