WMACleanupMonitor.javaAPI DocphoneME MR2 API (J2ME)4298Wed May 02 18:00:32 BST 2007com.sun.midp.wma


public class WMACleanupMonitor extends Object implements com.sun.midp.main.MIDletProxyListListener
The function of this class is to call a native WMA function, when a MIDletSuite terminates. The native function will perform any cleanup that is required, eg: delete any messages left unread by the MIDletSuite. This class implements the MIDletProxyListener interface and is thus notified whenever a MIDletSuite is installed or removed.

Two versions of this file exist: one which is a no-op, is used, when MIDP stack is not built with JSR 205 and the real implementation when MIDP stack is built with JSR205.

Fields Summary
Constructors Summary
private WMACleanupMonitor()
Prevents instantiation of this class.

Methods Summary
private native voiddeleteMessages0(int msid)
Native function to delete SMS/CBS/MMS messages left unread by the MIDlet suite that is terminating.

msid Midlet Suite ID.

public static voidinit(com.sun.midp.main.MIDletProxyList mpl)
Initialization function for the WMA cleanup service. Adds itself as a listener, so as to be notified on suite removal.

mpl A midlet proxy list, passed down by the suite loader.

        mpl.addListener(new WMACleanupMonitor());
public voidmidletAdded(com.sun.midp.main.MIDletProxy midlet)
The WMACleanup monitor ignores MIDlet added callbacks. The necessary initialization is done in the Isolate and MIDletState that instantiates the MIDlet. Called when a MIDlet is added to the list and only in the AMS Isolate.

midlet The proxy of the MIDlet being added

public voidmidletRemoved(com.sun.midp.main.MIDletProxy midlet)
The WMACleanup monitor uses the MIDlet removed callback to delete any messages left unread by the MIDlet suite.. Called (in the AMS Isolate) when a MIDlet is removed from the list.

midlet The proxy of the removed MIDlet

public voidmidletStartError(int externalAppId, int suiteId, java.lang.String className, int errorCode, java.lang.String errorDetails)
The WMACleanup monitor ignores MIDlet start error callbacks. Called when error occurred while starting a MIDlet object.

externalAppId ID assigned by the external application manager
suiteId Suite ID of the MIDlet
className Class name of the MIDlet
errorCode start error code
errorDetails start error details

public voidmidletUpdated(com.sun.midp.main.MIDletProxy midlet, int fieldId)
The WMACleanup monitor ignores MIDlet update callbacks. Called when the state of a MIDlet in the list is updated.

midlet The proxy of the MIDlet that was updated
fieldId code for which field of the proxy was updated, see constants above