Technical information

Chapter 5: JAVA API
July 15, 2008 G24 KJAVA User’s Guide 5-9
Once it is activated, the platform sends events every 10 seconds that can be caught by
OSCWdogListener interface implementer. This will allow the MIDlet to kick the watchdog timer
(by calling KickMIDletWatchdog) without maintaining its own Timer mechanism.
Note: The watchdog default state is not active.
WebSession Package
Package name: com.motorola.oem.websession
Web Session is a collection of parameters which configure and manage the Internet connection
(GPRS, MMS).
There are 2 types of web sessions used by Java platform for network (GPRS) connection. It is the
user responsibility to set these parameters which are operator's specific:
Java Session - used for all javax.microedition.io (MIDP2.0), with addition of OTADownload
APIs.
Mms Session - used for MMS send/receive (including emails).
Prov Session - used for session parameters provisioned by a browser message
FOTA Session - used for over-the-air update of the G24-J firmware. This session must be
initialized by the UM on power up.
OTADownload
The OTADownload class enables the UM to update itself over the air (JAD and JAR).
OTADownload is using "Java Session" parameters by default.
In order to enable the OTA download, UM should provide a URL to the requested MIDlet suite
along with all OTA websession parameters. Once the download process started, "there is no
return" and the running MIDlet will be closed.
MIDlet downloading and installing is fully automatic. In case of a successful download and
install, the new MIDlet will start automatically. In case of a failure, previous MIDlet will be
launched again (if it's the DM a report will be send to all saved report addresses).
OTADownload uses HTTP 1.1 and WAP 2.0 protocols.
WebSessionManager
The WebSessionManager class manages Web Sessions entries addition, deletion, update and
setting the "current" G24 Web Session.
Session provisioning-
Web session's OTA Provisioning is the process, by which the carrier configures a web session.
The user may "listen" to a "browser settings received" event, indicating the arrival of a new
"browser settings" (sent by the carrier). In case web session update is accepted by the MIDlet, the
"Prov Session" web session entry is overridden with the newly received settings.
The "browser settings" message may contain an optional parameter which indicates the security
mechanism used. If the parameter is not present, no security is used. If the parameter is present it
must take one of the values: AUTH_METHOD_NETWPIN,