|
||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |
See:
Description
Interface Summary | |
ExporterManager | The ExporterManager interface implementation which is the entry point to the ETA implementation. |
Class Summary | |
ExporterManagerFactory | The factory that produces ExporterManager objects |
Exception Summary | |
ConnectionException | Represents a connection-level exception |
ConnectionIOException | Represents an exception that is thrown when an I/O error occurs during reading or writing via the TCP connection. |
DataException | Represents an exception that is thrown when there is an error regarding the protocol data. |
InvalidApplicationStateException | Indicates an Invalid Application State |
InvalidSessionStateException | Indicates invalid state transition or message for a session. |
ProtocolMalformedMsgException | Represents the exception which provides the information about a mal-formed message. |
RequestAlreadySentException | Indicates a RequestAlreadySent error |
SessionException | Indicates session exception. |
UnknownRequestException | Indicates an UnknownRequestException error |
The Event Tracking API for Java ME - the root package. This package includes also the main interface for the Java ME developer (ExporterManager).
The ETA specification contains:
1. Event Tracking Java ME Configuration API – defined by this specification
2. Event Tracking Java ME API – defined by this specification
3. Event Tracking Underlying Protocol – Defined by ETA to be IPDR/SP
The Event Tracking Java ME Configuration API is a set of methods and interfaces that can be called by the Event Tracking Java ME API implementation in order to get configuration information, such as who are the available collector servers, what are the available event templates, etc.
The Event Tracking Java ME API is a set of methods and interfaces that can be called by a Java ME application to submit an event to a server. Classes that implement the Event Tracking Java ME API are known as the Event Tracking Java ME API implementation.
The Event Tracking Underlying Protocol is defined to be IPDR/SP and is the protocol between the micro edition device and the collection system.
The following sequence diagram depicts the flow of a typical event tracking process:
The scope of this JSR is to define the following:
1. The way to produce events from the device (exporter) to some collection system (Java API)
2. The way to define the configuration (what the available collectors are, what the templates supported by this instance of the exporter are)
2.1 Java API
2.2 JAD/Manifest attributes interface
3. The protocol to be employed between the device (exporter) and the collection system (but not to invent new protocol)
The IP Data Record Streaming Protocol (IPDR/SP) to be the underlying protocol between the exporter and the collection system is the protocol of choice for this JSR.
(IPDR/SP was found to be the proper protocol for the event tracking API underlying protocol because of its reliability, extensibility, and flexible, low bandwidths, etc.)
There are two issues that are not within the scope of this specification:
§ Event Templates
The specific set of attributes (template) to be sent as the tracking event is very much industry-dependent. There are standard bodies such as IPDR.org that standardize templates per service needs and define it as XML Schema definitions or the Open Mobile Alliance (OMA) Game Services working group that define the client server interface to enable the controlled usability of wireless games, e.g., the ability to execute games and have a standardized interaction with the game server. Therefore, this specification does not define a new template.
§ Communication Protocol
The IP Data Record Streaming Protocol (IPDR/SP) is the protocol of choice for the underlying protocol between the exporter and the collection system. IPDR/SP was found to be the appropriate underlying protocol for the Event Tracking API because of its reliability, extensibility, and flexible, low bandwidths, etc. Therefore, this specification does not define a new communication protocol.
|
||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |