com.intel.util
Class EventManager
- java.lang.Object
-
- com.intel.util.EventManager
-
public class EventManager extends java.lang.Object
This class allows applets' registration for receiving events as well as posting events to other applets in the system or the native layer/application.
-
-
Field Summary
Fields Modifier and Type Field and Description static int
ACTOR_APPLET
Event is destined to or originated from another applet in the system.static int
ACTOR_NATIVE
Event is destined to or originated from native layer/application.
-
Method Summary
Methods Modifier and Type Method and Description static void
post(int reason, byte[] data, int index, int length)
This method posts an event to all registered clients in the system.static void
post(int reason, byte[] data, int index, int length, java.lang.String targetUUID, int targetType)
This method posts an event to a specific applet (according to provided UUID) or the native layer.static void
register(int reason, EventClient client)
This method registers the providedEventClient
for handling events with the specified reason code.static void
unregister(int reason)
This method removes any previous registration of anEventClient
for the specified reason code.
-
-
-
Field Detail
-
ACTOR_NATIVE
public static final int ACTOR_NATIVE
Event is destined to or originated from native layer/application.- See Also:
- Constant Field Values
-
ACTOR_APPLET
public static final int ACTOR_APPLET
Event is destined to or originated from another applet in the system.- See Also:
- Constant Field Values
-
-
Method Detail
-
register
public static final void register(int reason, EventClient client) throws UtilException
This method registers the providedEventClient
for handling events with the specified reason code. Note that in order to be able to register for a specific event code, the applet must have this reason code included in the "applet.event.register" list in its configuration file (used during applet download package generation). If there was a previousEventClient
registered to the specified reason code its registration will be replaced with the new client.- Parameters:
reason
- reason code that the providedEventClient
will be handlingclient
- theEventClient
to be registered for handling the events. Must not be null.- Throws:
AccessDeniedException
- in case the reason code provided did not appear in this applet's configuration file ("applet.event.register" list).UtilException
-
unregister
public static final void unregister(int reason) throws UtilException
This method removes any previous registration of anEventClient
for the specified reason code. If no previous registration was done, calling this method will have no effect.- Parameters:
reason
- the reason code for un-registration- Throws:
AccessDeniedException
- in case the reason code provided did not appear in this applet's configuration file ("applet.event.register" list).UtilException
-
post
public static final void post(int reason, byte[] data, int index, int length, java.lang.String targetUUID, int targetType) throws UtilException
This method posts an event to a specific applet (according to provided UUID) or the native layer. Note that if the target applet has several instances in the system that registered for this event, all of them will receive the event notification. In addition, note that in order to be able to post an event with the specified event code, the applet must have this reason code included in the "applet.event.post" list in its configuration file (used during applet download package generation).- Parameters:
reason
- event code of the published eventdata
- byte array holding the data to be sent with eventindex
- start of the data to be send in the arraylength
- the length of the data to be senttargetUUID
- UUID string specifying the target applettargetType
- target type:ACTOR_NATIVE
orACTOR_APPLET
- Throws:
IllegalParameterException
- in one of the following cases: 1. specified target is invalid. 2. data is not null but the array is zero in size. 3. data is not null but length parameter is zero. 4. data is null but length parameter is not zero.AccessDeniedException
- in case the reason code provided did not appear in this applet's configuration file ("applet.event.post" list).UtilOutOfResourcesException
- in case the system has no resources available for sending this event.UtilException
-
post
public static final void post(int reason, byte[] data, int index, int length) throws UtilException
This method posts an event to all registered clients in the system. Note that in order to be able to post an event with the specified event code, the applet must have this reason code included in the "applet.event.post" list in its configuration file (used during applet download package generation).- Parameters:
reason
- event code of the published eventdata
- byte array holding the data to be sent with eventindex
- start of the data to be send in the arraylength
- the length of the data to be sent- Throws:
IllegalParameterException
- in one of the following cases: 1. data is not null but the array is zero in size. 2. data is not null but length parameter is zero. 3. data is null but length parameter is not zero.AccessDeniedException
- in case the reason code provided did not appear in this applet's configuration file ("applet.event.post" list).UtilOutOfResourcesException
- in case the system has no resources available for sending this event.UtilException
-
-