public interface ItemEventListener
DataProvider
Modifier and Type | Method and Description |
---|---|
void |
clearSnapshot(java.lang.String itemName)
Called by a Data Adapter to signal to Lightstreamer Kernel that the
current Snapshot of an Item has suddenly become empty.
|
void |
endOfSnapshot(java.lang.String itemName)
Called by a Data Adapter to signal to Lightstreamer Kernel that no more
ItemEvent belonging to the Snapshot are expected for an Item.
|
void |
failure(java.lang.Throwable e)
Called by a Data Adapter to notify Lightstreamer Kernel of the
occurrence of a severe problem that can compromise future operation
of the Data Adapter.
|
void |
smartClearSnapshot(java.lang.Object itemHandle)
Can be called, instead of clearSnapshot, by a Data Adapter that
implements the extended interface SmartDataProvider, in all cases
in which clearSnapshot can be called.
|
void |
smartEndOfSnapshot(java.lang.Object itemHandle)
Can be called, instead of endOfSnapshot, by a Data Adapter that
implements the extended interface SmartDataProvider, in all cases
in which endOfSnapshot can be called.
|
void |
smartUpdate(java.lang.Object itemHandle,
IndexedItemEvent event,
boolean isSnapshot)
Can be called by a Data Adapter that implements the extended interface
SmartDataProvider to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an IndexedItemEvent instance.
|
void |
smartUpdate(java.lang.Object itemHandle,
ItemEvent event,
boolean isSnapshot)
Can be called by a Data Adapter that implements the extended interface
SmartDataProvider to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an ItemEvent instance.
|
void |
smartUpdate(java.lang.Object itemHandle,
java.util.Map event,
boolean isSnapshot)
Can be called by a Data Adapter that implements the extended interface
SmartDataProvider to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as a java.util.Map instance.
|
void |
smartUpdate(java.lang.Object itemHandle,
OldItemEvent event,
boolean isSnapshot)
Can be called by a Data Adapter that implements the extended interface
SmartDataProvider to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an OldItemEvent instance.
|
void |
update(java.lang.String itemName,
IndexedItemEvent event,
boolean isSnapshot)
Called by a Data Adapter to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an IndexedItemEvent instance.
|
void |
update(java.lang.String itemName,
ItemEvent event,
boolean isSnapshot)
Called by a Data Adapter to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an ItemEvent instance.
|
void |
update(java.lang.String itemName,
java.util.Map event,
boolean isSnapshot)
Called by a Data Adapter to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as a java.util.Map instance.
|
void |
update(java.lang.String itemName,
OldItemEvent event,
boolean isSnapshot)
Called by a Data Adapter to send an ItemEvent to Lightstreamer Kernel
when the ItemEvent is implemented as an OldItemEvent instance.
|
void update(java.lang.String itemName, ItemEvent event, boolean isSnapshot)
itemName
- The name of the Item whose values are carried by the
ItemEvent.event
- An ItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.DataProvider
void update(java.lang.String itemName, OldItemEvent event, boolean isSnapshot)
itemName
- The name of the Item whose values are carried by the
ItemEvent.event
- An OldItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.DataProvider
void update(java.lang.String itemName, java.util.Map event, boolean isSnapshot)
itemName
- The name of the Item whose values are carried by the
ItemEvent.event
- A java.util.Map instance, in which Field names are
associated to Field values. A Field value can be null or missing
if the Field is not to be reported in the event.
ItemEvent.getValue(String)
for details.isSnapshot
- true if the ItemEvent carries the Item Snapshot.DataProvider
void update(java.lang.String itemName, IndexedItemEvent event, boolean isSnapshot)
itemName
- The name of the Item whose values are carried by the
ItemEvent.event
- An IndexedItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.DataProvider
void smartUpdate(java.lang.Object itemHandle, ItemEvent event, boolean isSnapshot)
itemHandle
- Identifies the Item whose values are carried by the
ItemEvent. It must be the same object received in the subscribe call.event
- An ItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.SmartDataProvider
void smartUpdate(java.lang.Object itemHandle, OldItemEvent event, boolean isSnapshot)
itemHandle
- Identifies the Item whose values are carried by the
ItemEvent. It must be the same object received in the subscribe call.event
- An OldItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.SmartDataProvider
void smartUpdate(java.lang.Object itemHandle, java.util.Map event, boolean isSnapshot)
itemHandle
- Identifies the Item whose values are carried by the
ItemEvent. It must be the same object received in the subscribe call.event
- A java.util.Map instance, in which Field names are
associated to Field values. A Field value can be null or missing
if the Field is not to be reported in the event.
ItemEvent.getValue(String)
for details.isSnapshot
- true if the ItemEvent carries the Item Snapshot.SmartDataProvider
void smartUpdate(java.lang.Object itemHandle, IndexedItemEvent event, boolean isSnapshot)
itemHandle
- Identifies the Item whose values are carried by the
ItemEvent. It must be the same object received in the subscribe call.event
- An IndexedItemEvent instance.isSnapshot
- true if the ItemEvent carries the Item Snapshot.SmartDataProvider
void endOfSnapshot(java.lang.String itemName)
itemName
- The name of the Item whose Snapshot has been completed.DataProvider
void smartEndOfSnapshot(java.lang.Object itemHandle)
itemHandle
- Identifies an Item whose Snapshot has been completed.endOfSnapshot(java.lang.String)
,
SmartDataProvider
void clearSnapshot(java.lang.String itemName)
DataProvider.isSnapshotAvailable(java.lang.String)
for the specified Item;
moreover, if invoked while the Snapshot is being supplied, the Kernel
will infer that the Snapshot has been completed.
itemName
- The name of the Item whose Snapshot has become empty.DataProvider
void smartClearSnapshot(java.lang.Object itemHandle)
itemHandle
- Identifies an Item whose Snapshot has become empty.clearSnapshot(java.lang.String)
,
SmartDataProvider
void failure(java.lang.Throwable e)
e
- any java.lang.Throwable object, with the description of
the problem.