de.novanic.eventservice.client.connection.strategy.connector.streaming

Class DefaultStreamingClientConnector

java.lang.Object

de.novanic.eventservice.client.connection.strategy.connector.streaming.DefaultStreamingClientConnector

All Implemented Interfaces:

ConnectionStrategyClientConnector

public abstract class DefaultStreamingClientConnector
extends Object
implements ConnectionStrategyClientConnector

The ConnectionStrategyClientConnector listens for occurred events (Event) of the server side and has the task to encode / process the transferred events at the client side. The DefaultStreamingClientConnector is an abstract implementation for streaming listen methods and needs an implementation to deserialize sent events. Streaming means that the connection is hold open for a specified time and when an event occurs, the answer / event is streamed directly to the client without closing and re-open the connection. The connection is closed and re-opened (by the client) when the configured max. waiting time is reached.

Author:

sstrohschein
Date: 18.03.2010
Time: 00:07:46

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	CYCLE_TAG

Constructor Summary

Constructors

Constructor and Description
DefaultStreamingClientConnector()

Method Summary

Methods

Modifier and Type	Method and Description
void	deactivate() Deactivates the ConnectionStrategyClientConnector.
protected abstract DomainEvent	deserializeEvent(String anEvent) That de-serialization method has to be implemented by the extending implementation to de-serialize occurred events.
void	init(EventServiceAsync anEventService) Initializes the ConnectionStrategyClientConnector with the EventServiceAsync.
boolean	isInitialized() Checks if the ConnectionStrategyClientConnector is initialized.
protected abstract void	listen() That method can be implemented to react on a listen start call.
void	listen(EventNotification anEventNotification, AsyncCallback<List<DomainEvent>> aCallback) The listen method implements the listen / connection strategy to receive occurred events.
void	receiveEvent(String anEvent) That method can be used by a concrete implementation to sent received events.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CYCLE_TAG

protected static final String CYCLE_TAG

See Also:

Constant Field Values

Constructor Detail

DefaultStreamingClientConnector

public DefaultStreamingClientConnector()

Method Detail

init

public void init(EventServiceAsync anEventService)

Initializes the ConnectionStrategyClientConnector with the EventServiceAsync.

Specified by:

init in interface ConnectionStrategyClientConnector

Parameters:

anEventService - the EventServiceAsync

deactivate

public void deactivate()

Deactivates the ConnectionStrategyClientConnector.

Specified by:

deactivate in interface ConnectionStrategyClientConnector

isInitialized

public boolean isInitialized()

Checks if the ConnectionStrategyClientConnector is initialized.

Specified by:

isInitialized in interface ConnectionStrategyClientConnector

Returns:

true when the ConnectionStrategyClientConnector is initialized, otherwise false

listen

public void listen(EventNotification anEventNotification,
          AsyncCallback<List<DomainEvent>> aCallback)

The listen method implements the listen / connection strategy to receive occurred events. The occurred events will be passed to the EventNotification and to the callback. That abstract streaming implementation handles the notifications itself. The concrete implementation has to implement the abstract listen method (listen()) and can notify about events with a simple call to receiveEvent(String).

Specified by:

listen in interface ConnectionStrategyClientConnector

Parameters:

anEventNotification - EventNotification which will be notified about occurred / received events

aCallback - The callback will be notified about occurred / received events.

receiveEvent

public void receiveEvent(String anEvent)

That method can be used by a concrete implementation to sent received events. It de-serializes the event and notifies the callback and the EventNotification about the occurred event, itself. The callback isn't notified about events when the cycle (CYCLE_TAG) is triggered, because the events were already processed to the EventNotification before.

Parameters:

anEvent - event or cycle tag (CYCLE_TAG)

deserializeEvent

protected abstract DomainEvent deserializeEvent(String anEvent)

That de-serialization method has to be implemented by the extending implementation to de-serialize occurred events.

Parameters:

anEvent - event to de-serialize

Returns:

de-serialized event

listen

protected abstract void listen()

That method can be implemented to react on a listen start call. That method is executed by listen(de.novanic.eventservice.client.event.listener.EventNotification, com.google.gwt.user.client.rpc.AsyncCallback).