| java.lang.Object
 com.sun.midp.main.MIDletControllerEventProducer
| MIDletControllerEventProducer | | public class MIDletControllerEventProducer (Code) | | This class provides methods to send events of types
handled by MIDletControllerEventConsumer I/F implementors.
This class completely hide event construction & sending in its methods.
This class is intended to be used by MIDletStateHandler & MIDletPeer
classes in Allication Isolate.
So in some of its sendXXXEvent()methods we can change int IDs to
MIDletPeer references.
Generic comments for all XXXEventProducers:
For each supported event type there is a separate sendXXXEvent() method,
that gets all needed parameters to construct an event of an approprate class.
The method also performs event sending itself.
If a given event type merges a set of logically different subtypes,
this class shall provide separate methods for these subtypes.
It is assumed that only one object instance of this class
is initialized with the system event that is created at (isolate) startup.
This class only operates on the event queue given to it during
construction, the class does not obtain any restricted object itself,
so it does not need protection.
All MIDP stack subsystems that need to send events of supported types,
must get a reference to an already created istance of this class.
Typically, this instance should be passed as a constructor parameter.
Class is NOT final to allow debug/profile/test/automation subsystems
to change, substitute, complement default "event sending" functionality :
Ex.
class LogXXXEventProducer
extends XXXEventProducer {
...
void sendXXXEvent(parameters) {
LOG("Event of type XXX is about to be sent ...")
super.sendXXXEvent(parameters);
LOG("Event of type XXX has been sent successfully !")
}
...
}
|
| Constructor Summary | |
| public | MIDletControllerEventProducer(EventQueue theEventQueue, int theAmsIsolateId, int theCurrentIsolateId)
Construct a new MIDletControllerEventProducer. |
| Method Summary | |
| public void | sendDisplayBackgroundRequestEvent(int midletDisplayId)
Called to send a background request event to the AMS isolate. | | public void | sendDisplayCreateNotifyEvent(int midletDisplayId, String midletClassName)
Called to send a Display created notification to the AMS isolate. | | public void | sendDisplayForegroundRequestEvent(int midletDisplayId, boolean isAlert)
Called to send a foreground request event to the AMS isolate. | | public void | sendDisplayPreemptStartEvent(int midletDisplayId)
Called to start preempting and end preempting.
Probably: will need more parameters, ex. | | public void | sendDisplayPreemptStopEvent(int midletDisplayId)
Called to start preempting and end preempting.
Probably: will need more parameters, ex. | | public void | sendMIDletActiveNotifyEvent(int midletSuiteId, String midletClassName)
Called to send a MIDlet active notification to the AMS isolate. | | public void | sendMIDletCreateNotifyEvent(int midletSuiteId, String midletClassName, int midletExternalAppId, String midletDisplayName)
Called to send a MIDlet created notification to the AMS isolate. | | public void | sendMIDletDestroyNotifyEvent(int midletSuiteId, String midletClassName)
Called to send a MIDlet destroyed notification to the AMS isolate. | | public void | sendMIDletDestroyRequestEvent(int midletDisplayId)
Called by the display to request the central AMS to destroy the owning
MIDlet. | | public void | sendMIDletForegroundTransferEvent(int originMIDletSuiteId, String originMIDletClassName, int targetMIDletSuiteId, String targetMIDletClassName)
Called to send a foreground MIDlet transfer event to the AMS isolate. | | public void | sendMIDletPauseNotifyEvent(int midletSuiteId, String midletClassName)
Called to send a MIDlet paused notification to the AMS isolate. | | public void | sendMIDletResumeRequest(int midletSuiteId, String midletClassName)
Called to send a MIDlet resume request to the AMS isolate. | | public void | sendMIDletRsPauseNotifyEvent(int midletSuiteId, String midletClassName)
Sends notification for MIDlet resources pause to the AMS isolate. | | public void | sendMIDletStartErrorEvent(int midletSuiteId, String midletClassName, int midletExternalAppId, int errorCode, String errorDetails)
| | public void | sendSetForegroundByNameRequestEvent(int suiteId, String className)
Called to send a request to AMS isolate for a MIDlet be in
the foreground. |
| amsIsolateId | | protected int amsIsolateId(Code) | | Cached reference to AMS isolate ID.
|
| currentIsolateId | | protected int currentIsolateId(Code) | | Cached reference to current isolate ID.
|
| eventQueue | | protected EventQueue eventQueue(Code) | | Cached reference to the MIDP event queue.
|
| midletActiveEvent | | final NativeEvent midletActiveEvent(Code) | | Preallocate MIDlet active event to work in case of out of memory
|
| midletCreatedEvent | | final NativeEvent midletCreatedEvent(Code) | | Preallocate MIDlet created event to work in case of out of memory
|
| midletDestroyedEvent | | final NativeEvent midletDestroyedEvent(Code) | | Preallocate MIDlet destroyed event to work in case of out of memory
|
| midletPausedEvent | | final NativeEvent midletPausedEvent(Code) | | Preallocate MIDlet paused event to work in case of out of memory
|
| midletRsPausedEvent | | final NativeEvent midletRsPausedEvent(Code) | | Preallocate MIDlet resources paused event to work in case of out
of memory
|
| startErrorEvent | | final NativeEvent startErrorEvent(Code) | | Preallocate start error event to work in case of out of memory
|
| MIDletControllerEventProducer | | public MIDletControllerEventProducer(EventQueue theEventQueue, int theAmsIsolateId, int theCurrentIsolateId)(Code) | | Construct a new MIDletControllerEventProducer.
Parameters:
theEventQueue - An event queue where new events will be posted.
Parameters:
theAmsIsolateId - AMS Isolate Id
Parameters:
theCurrentIsolateId - Current Isolate Id |
| sendDisplayBackgroundRequestEvent | | public void sendDisplayBackgroundRequestEvent(int midletDisplayId)(Code) | | Called to send a background request event to the AMS isolate.
Parameters:
midletDisplayId - ID of the sending Display |
| sendDisplayCreateNotifyEvent | | public void sendDisplayCreateNotifyEvent(int midletDisplayId, String midletClassName)(Code) | | Called to send a Display created notification to the AMS isolate.
Parameters:
midletDisplayId - ID of the sending Display
Parameters:
midletClassName - Class name of the MIDlet that owns the display |
| sendDisplayForegroundRequestEvent | | public void sendDisplayForegroundRequestEvent(int midletDisplayId, boolean isAlert)(Code) | | Called to send a foreground request event to the AMS isolate.
Parameters:
midletDisplayId - ID of the sending Display
Parameters:
isAlert - true if the current displayable is an Alert |
| sendDisplayPreemptStartEvent | | public void sendDisplayPreemptStartEvent(int midletDisplayId)(Code) | | Called to start preempting and end preempting.
Probably: will need more parameters, ex. MIDlet ID
Parameters:
midletDisplayId - ID of the sending Display |
| sendDisplayPreemptStopEvent | | public void sendDisplayPreemptStopEvent(int midletDisplayId)(Code) | | Called to start preempting and end preempting.
Probably: will need more parameters, ex. MIDlet ID
Parameters:
midletDisplayId - ID of the sending Display |
| sendMIDletActiveNotifyEvent | | public void sendMIDletActiveNotifyEvent(int midletSuiteId, String midletClassName)(Code) | | Called to send a MIDlet active notification to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet |
| sendMIDletCreateNotifyEvent | | public void sendMIDletCreateNotifyEvent(int midletSuiteId, String midletClassName, int midletExternalAppId, String midletDisplayName)(Code) | | Called to send a MIDlet created notification to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet
Parameters:
midletExternalAppId - ID of given by an external applicationmanager
Parameters:
midletDisplayName - name to show the user |
| sendMIDletDestroyNotifyEvent | | public void sendMIDletDestroyNotifyEvent(int midletSuiteId, String midletClassName)(Code) | | Called to send a MIDlet destroyed notification to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet |
| sendMIDletDestroyRequestEvent | | public void sendMIDletDestroyRequestEvent(int midletDisplayId)(Code) | | Called by the display to request the central AMS to destroy the owning
MIDlet.
Parameters:
midletDisplayId - ID of the sending Display |
| sendMIDletForegroundTransferEvent | | public void sendMIDletForegroundTransferEvent(int originMIDletSuiteId, String originMIDletClassName, int targetMIDletSuiteId, String targetMIDletClassName)(Code) | | Called to send a foreground MIDlet transfer event to the AMS isolate.
Former: NEW method, originally sent from CHAPI
Parameters:
originMIDletSuiteId - ID of MIDlet from whichto take forefround ownership away,
Parameters:
originMIDletClassName - Name of MIDlet from whichto take forefround ownership away
Parameters:
targetMIDletSuiteId - ID of MIDletto give forefround ownership to,
Parameters:
targetMIDletClassName - Name of MIDletto give forefround ownership to |
| sendMIDletPauseNotifyEvent | | public void sendMIDletPauseNotifyEvent(int midletSuiteId, String midletClassName)(Code) | | Called to send a MIDlet paused notification to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet |
| sendMIDletResumeRequest | | public void sendMIDletResumeRequest(int midletSuiteId, String midletClassName)(Code) | | Called to send a MIDlet resume request to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet |
| sendMIDletRsPauseNotifyEvent | | public void sendMIDletRsPauseNotifyEvent(int midletSuiteId, String midletClassName)(Code) | | Sends notification for MIDlet resources pause to the AMS isolate.
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet |
| sendMIDletStartErrorEvent | | public void sendMIDletStartErrorEvent(int midletSuiteId, String midletClassName, int midletExternalAppId, int errorCode, String errorDetails)(Code) | | Notifies AMS that MIDlet creation failed
NEW: earlier it has been explicitely generated by
void static AppIsolateMIDletSuiteLoader.main(...)
Parameters:
midletExternalAppId - ID of given by an external applicationmanager
Parameters:
midletSuiteId - ID of the MIDlet suite
Parameters:
midletClassName - Class name of the MIDlet
Parameters:
errorCode - start error code |
| sendSetForegroundByNameRequestEvent | | public void sendSetForegroundByNameRequestEvent(int suiteId, String className)(Code) | | Called to send a request to AMS isolate for a MIDlet be in
the foreground.
Parameters:
suiteId - MIDlet's suite ID
Parameters:
className - MIDlet's class name |
|
|