SHOW Signed

net.rim.device.api.lowmemory
Interface LowMemoryListener

public interface LowMemoryListener

A listener interface for receiving and reacting to low memory events.

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 3.6.0

See Also:

LowMemoryFailedListener, LowMemoryManager

Field Summary

	static int	HIGH_PRIORITY The highest priority of low memory requests.
	static int	LOW_PRIORITY The lowest priority of low memory requests.
	static int	MEDIUM_PRIORITY The middle priority of low memory requests.

Method Summary

boolean

freeStaleObject(int priority) Called when the amount of available flash on the device has dropped below a safe level.

Field Detail

LOW_PRIORITY

public static final int LOW_PRIORITY

The lowest priority of low memory requests.

In response to requests at LOW_PRIORITY, the listener should only free non-critical objects such as cached data.

Since:

JDE 3.6.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.

MEDIUM_PRIORITY

public static final int MEDIUM_PRIORITY

The middle priority of low memory requests.

In response to requests at MEDIUM_PRIORITY, the listener should free objects that are "stale" such as very old unfiled messages or old calendar entries.

Since:

JDE 3.6.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.

HIGH_PRIORITY

public static final int HIGH_PRIORITY

The highest priority of low memory requests.

In response to requests at HIGH_PRIORITY, the listener should free any objects that it considers to be "stale" in an effort to meet the memory requirements.

Since:

JDE 3.6.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.

Method Detail

freeStaleObject

public boolean freeStaleObject(int priority)

Called when the amount of available flash on the device has dropped below a safe level.

In response to this call, the listener should attempt to free one stale persistent object, and call LowMemoryManager.markAsRecoverable(Object o) to indicate to the VM the amount of flash freed.

Parameters:

priority - The priority level of the request. Listeners should use parameter to determine what types of objects are to be freed.

Returns:

true if some persistent object was released; false otherwise.

Since:

JDE 3.7.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.