Package com.valescom.support.event.java

The eventhandling package provides a way for handling events on thread level, on process level, and on system level.

See:
Description

Interface Summary

EventGateway	Responsibility: Providing an interface to an external event gateway.
EventVisitor	Responsibility: Providing a visitor interface for Events.

Class Summary

AckEvent	Responsibility: Acknowledging the receipt of an AddressedEvent.
AddressedEvent	Responsibility: Representing a RemoteEvent addressed to a specific process.
BaseEventGateway	Responsibility: Providing a base EventGateway implementation.
BaseEventVisitor	Responsibility: Providing a base implementation for the EventVisitor.
DataEvent	Responsibility: Providing a LocalEvent implementation that contains data.
Event	Responsibility: Providing a base class for all event-like objects.
EventDispatcher	Responsibility: Dispatching all published events to the subscribed Handlers in its thread.
EventHandler	Responsibility: Handling Events based on a Subscription.
EventLoop	Responsibility: Running an EventDispatcher for a short period to enable testing of Event-based functionality.
EventManager	Responsibility: Forwarding each Event to the subscribed Handlers when an Event is published.
EventSleeper
EventThread	Responsibility: Running an EventDispatcher in it's own Thread.
Handler	Responsibility: Providing a base implementation for Handlers.
LocalEvent	Responsibility: Representing an Event for communicating within a process.
MultiEventHandler	Responsibility: Handling multiple subscriptions.
NackEvent	Responsibility: Indicating that the receipt of an AddressedEvent can not be acknowledged.
RemoteEvent	Responsibility: Representing an Event that can be published to an other process.

Package com.valescom.support.event.java Description

The eventhandling package provides a way for handling events on thread level, on process level, and on system level.

Eventhandling is based on the publish/subscribe model (see com.valescom.support.subscription.java).

In this package subscribers are called eventhandlers and publications are called events.

Design Rules

• To define special process local events extend LocalEvent.
• To define special inter process events extend RemoteEvent.
• To define event handlers extend EventHandler and override the handle method.

Registry

Type	Key	Description
int	QueueCapacity	The capacity of the EventDispatcher queues.
String	Host	The hostname of the machine running the Message Oriented Middleware server.
String	Server	The id of Message Oriented Middleware server.
int	Port	The port on the Message Oriented Middleware server runs.
String	User	The user for the Message Oriented Middleware server.
String	Password	The password for the Message Oriented Middleware server.