Package com.prosyst.mprm.backend.event

This package contains the API of the mPower Event service.

See: Description

Interface Summary

Interface	Description
Event	Encapsulates information about an event for use by the event listeners residing on mPRM backend hosts.
EventListener	Represents event consumer.
EventService	Service interface intended for event generator objects.

Exception Summary

Exception	Description
EventListenerException	This exception can be thrown by synchronous EventListener as a result event processing.

Package com.prosyst.mprm.backend.event Description

This package contains the API of the mPower Event service. The mPower Event service provides system and application components with mechanism for asyncronuous one-to-many communication specifically suited for the distributed nature of the mPRM. It is a powerful instrument for broadcasting and receiving notifications about changes in the state of resources maintained by the system and the applications. The event service can be used by component deployed on the mPRM Backend Hosts and by external applications connecting to the mPRM through the Remote Access Client component. The external applications can only receive events, while the backend components are able both to send and receive events.
Sending of events is performed through the methods of the EventService interface.
Receiving of events is enabled by registering instance of the EventListener interface. Backend components register event listeners by registering the EventListener instance as service in the OSGi framework, while the external applications do this by using RemoteAccessClient.addEventListener(java.lang.String type, com.prosyst.mprm.backend.event.EventListener listener) method.
Events can processed either synchronously or asynchronously. Synchronously processing means that the event sended is blocked until the event listeners receives and processed the event, while asynchronously means that the event is delivered to the listeners in separated thread (i.e. event sender does not wait event delivery and processing). External applications can only receive events asynchronously.