SHOW Signed

net.rim.device.api.memorycleaner
Class MemoryCleanerDaemon

java.lang.Object
  |
  +--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 clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 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.
Since:
JDE 4.0.0
See Also:
removeListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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.
Since:
JDE 4.0.2
See Also:
removeListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

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.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

cleanAll

public static void cleanAll()
Starts a programmatic clean of the registered memory cleaner listeners.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

removeListener

public static void removeListener(MemoryCleanerListener listener)
Removes provided listener from this daemon's registry.
Parameters:
listener - Listener to remove.
Since:
JDE 4.0.0
See Also:
addListener(net.rim.device.api.memorycleaner.MemoryCleanerListener)
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2007 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.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.