com.lightstreamer.ls_client
Interface FastItemsListener

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

public interface FastItemsListener

A fast, though basic, listener interface, which receives notification of data updates and subscription termination for a list of items that have been subscribed using LSClient.subscribeItems(ExtendedTableInfo, FastItemsListener).
Only notifications of changed field values received from the Server are available. Unchanged fields are just reported through the UNCHANGED constant. The items involved in the notifications are identified with reference to their position in the related subscription request. Specific fields are also identified by positional information.

Field Summary

static java.lang.String

UNCHANGED Deprecated. Constant that represents unchanged fields.

Method Summary

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

Field Detail

UNCHANGED

static final java.lang.String UNCHANGED

Deprecated.

Constant that represents unchanged fields. Object identity rather than object equality must be tested; a string value of "UNCHANGED" may be a legal value coming from Lightstreamer Server Data Adapter.

Method Detail

onUpdate

void onUpdate(int item,
              java.lang.String[] values)

Deprecated.

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

Parameters:

item - 1-based index of the item in the list of subscribed items.

values - Array of values received from the Server. The values are reported in the same order as the fields in the Schema of the items. Some values may be null. In case of unchanged values, the UNCHANGED constant is reported.

onSnapshotEnd

void onSnapshotEnd(int 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 - 1-based index of the item in the Group of items in the table.

onRawUpdatesLost

void onRawUpdatesLost(int 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 - 1-based index of the item in the list of subscribed items.

lostUpdates - Number of consecutive lost updates for the item.

onUnsubscr

void onUnsubscr(int item)

Deprecated.

Notification of the unsubscription of an item in the list. 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.

Parameters:

item - 1-based index of the item in the list of subscribed items.