com.lightstreamer.ls_client
Interface ExtendedTableListener

Deprecated. The use of this listener is deprecated in favor of the HandyTableListener and the subscribe methods based on it.

public interface ExtendedTableListener

A fast, though basic, listener interface, which receives notification of data updates and subscription termination for a table. It can be used in place of SimpleTableListener when item and field name information is available (that is, a LiteralBasedProvider or equivalent Metadata Adapter is configured on the Server).
Only notifications of changed field values received from the Server are available. Unchanged fields are just not included in the update representations.

Method Summary

void	onRawUpdatesLost(java.lang.String item, int lostUpdates) Deprecated. Notification of one or more updates that were suppressed in the Server because of internal memory limitations.
void	onSnapshotEnd(java.lang.String item) Deprecated. Notification that no more snapshot events are coming for an item.
void	onUnsubscr(java.lang.String item) Deprecated. Notification of the unsubscription of an item in the table.
void	onUnsubscrAll() Deprecated. Notification of the unsubscription of all the items in the table.
void	onUpdate(java.lang.String item, java.util.Map fields) Deprecated. Notification of an update of the values for an item in the table.

Method Detail

onUpdate

void onUpdate(java.lang.String item,
              java.util.Map fields)

Deprecated.

Notification of an update of the values for an item in the table.

Parameters:

item - Name of the changed item.

fields - Map that associates field names to new values. Some values may be null. In case of unchanged values, the field-value pairs are not stored.

onSnapshotEnd

void onSnapshotEnd(java.lang.String item)

Deprecated.

Notification that no more snapshot events are coming for an item. This notification is always received once, when the item is subscribed in DISTINCT or COMMAND mode and the snapshot is requested.

Parameters:

item - Name of the item.

onRawUpdatesLost

void onRawUpdatesLost(java.lang.String item,
                      int lostUpdates)

Deprecated.

Notification of one or more updates that were suppressed in the Server because of internal memory limitations. The notification can be sent if the subscription mode is RAW or COMMAND. It can also be sent if the subscription mode is MERGE or DISTINCT and unfiltered dispatching has been requested. In all these cases, an update loss may be unacceptable for the client (in filtered COMMAND mode, this applies to ADD and DELETE events only).

Parameters:

item - Name of the item.

lostUpdates - Number of consecutive lost updates for the item.

onUnsubscr

void onUnsubscr(java.lang.String item)

Deprecated.

Notification of the unsubscription of an item in the table. It is sent for all items before onUnsubscrAll.

Parameters:

item - Name of an item.

onUnsubscrAll

void onUnsubscrAll()

Deprecated.

Notification of the unsubscription of all the items in the table. The unsubscription may be subsequent to an unsubscribeTable call or to the closure of the connection. There is no guarantee that this call will not be followed by some further onUpdate call. Such extra calls should be ignored.