FileDocCategorySizeDatePackage
MIDletControllerEventConsumer.javaAPI DocphoneME MR2 API (J2ME)10158Wed May 02 18:00:06 BST 2007com.sun.midp.main

MIDletControllerEventConsumer

public interface MIDletControllerEventConsumer
This interface is to be implemnted by an event processing target for MIDlet events on MIDlet controller (i.e. AMS) side. EventListener for these events must find appropriate instance of this I/F implementor and call its methods. TBD: although Consumer I/F is intended to be instance specific, the implementor of this one shall be assosiated with a MIDletProxyList, which is a single static object that exists only in AMS isolate ... However, I/F implementor shall NOT assume that it is a static singleton object ... TBD: method and parameter lists of the I/F is preliminary and is a subject for changes. TBD: it makes sence replace some handlerXXXEvent method parameters (isolateId, displayId) by MIdletProxy object that is able to provide all needed information to process event.

Fields Summary
Constructors Summary
Methods Summary
public voidhandleActivateAllEvent()
Processes ACTIVATE_ALL_EVENT

public voidhandleDestroyAllEvent()
Processes SHUTDOWN_ALL_EVENT

public voidhandleDisplayBackgroundRequestEvent(int midletIsolateId, int midletDisplayId)
Processes BACKGROUND_REQUEST event TBD: param midletProxy proxy with information about MIDlet

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display

public voidhandleDisplayCreateNotifyEvent(int midletIsolateId, int midletDisplayId, java.lang.String midletClassName)
Processes DISPLAY_CREATED_NOTIFICATION event, parameters - set the display id of a MIDletProxy object instance

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display
param
midletClassName Class name of the MIDlet

public voidhandleDisplayForegroundRequestEvent(int midletIsolateId, int midletDisplayId, boolean isAlert)
Processes FOREGROUND_REQUEST event TBD: param midletProxy proxy with information about MIDlet

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display
param
isAlert true if the current displayable is an Alert

public voidhandleDisplayPreemptStartEvent(int midletIsolateId, int midletDisplayId)
Processes PREEMPT_EVENT(true), parameters - to create MIDletProxy object instance

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display

public voidhandleDisplayPreemptStopEvent(int midletIsolateId, int midletDisplayId)
Processes PREEMPT_EVENT(false),

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display

public voidhandleFatalErrorNotifyEvent(int midletIsolateId, int midletDisplayId)
Processes FATAL_ERROR_NOTIFICATION event

param
midletIsolateId isolate ID of the sending isolate
param
midletDisplayId ID of the sending Display

public voidhandleMIDletActiveNotifyEvent(int midletSuiteId, java.lang.String midletClassName)
Processes MIDLET_ACTIVE_NOTIFICATION event TBD: param midletProxy proxy with information about MIDlet

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet

public voidhandleMIDletCreateNotifyEvent(int midletSuiteId, java.lang.String midletClassName, int midletIsolateId, int midletExternalAppId, java.lang.String midletDisplayName)
Processes MIDLET_CREATED_NOTIFICATION event, parameters - to create MIDletProxy object instance

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet
param
midletIsolateId isolate ID of the sending MIDlet
param
midletExternalAppId ID of given by an external application manager
param
midletDisplayName name to show the user

public voidhandleMIDletDestroyNotifyEvent(int midletSuiteId, java.lang.String midletClassName)
Processes MIDLET_DESTROYED_NOTIFICATION event TBD: param midletProxy proxy with information about MIDlet

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet

public voidhandleMIDletDestroyRequestEvent(int midletIsolateId, int midletDisplayId)
Processes MIDLET_DESTROY_REQUEST event TBD: param midletProxy proxy with information about MIDlet

param
midletIsolateId isolate ID of the sending Display
param
midletDisplayId ID of the sending Display

public voidhandleMIDletForegroundSelectEvent(int onlyFromLaunched)
Processes SELECT_FOREGROUND event

public voidhandleMIDletForegroundTransferEvent(int originMIDletSuiteId, java.lang.String originMIDletClassName, int targetMIDletSuiteId, java.lang.String targetMIDletClassName)
Processes FOREGROUND_TRANSFER event

param
originMIDletSuiteId ID of MIDlet from which to take forefround ownership away,
param
originMIDletClassName Name of MIDlet from which to take forefround ownership away
param
targetMIDletSuiteId ID of MIDlet to give forefround ownership to,
param
targetMIDletClassName Name of MIDlet to give forefround ownership to

public voidhandleMIDletPauseNotifyEvent(int midletSuiteId, java.lang.String midletClassName)
Processes MIDLET_PAUSED_NOTIFICATION event TBD: param midletProxy proxy with information about MIDlet

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet

public voidhandleMIDletResumeRequestEvent(int midletSuiteId, java.lang.String midletClassName)
Processes a MIDLET_RESUME_REQUEST event. TBD: param midletProxy proxy with information about MIDlet

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet

public voidhandleMIDletRsPauseNotifyEvent(int midletSuiteId, java.lang.String midletClassName)
Processes MIDLET_RS_PAUSED_NOTIFICATION event TBD: param midletProxy proxy with information about MIDlet

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet

public voidhandleMIDletStartErrorEvent(int midletSuiteId, java.lang.String midletClassName, int midletExternalAppId, int errorCode, java.lang.String errorDetails)
Processes MIDLET_START_ERROR event

param
midletSuiteId ID of the MIDlet suite
param
midletClassName Class name of the MIDlet
param
midletExternalAppId ID of given by an external application manager
param
errorCode start error code
param
errorDetails start error details

public voidhandlePauseAllEvent()
Processes PAUSE_ALL_EVENT

public voidhandleSetForegroundByNameRequestEvent(int suiteId, java.lang.String className)
Processes SET_FOREGROUND_BY_NAME_REQUEST

param
suiteId MIDlet's suite ID
param
className MIDlet's class name