Package com.lightstreamer.interfaces.metadata

Class SubscriptionStatistics

java.lang.Object
com.lightstreamer.interfaces.metadata.SubscriptionStatistics
public final class SubscriptionStatistics extends Object
Used by Lightstreamer to provide to method TableInfo.getSubscriptionStatistics() value objects to report activity statistics for single subscribed items involved in a Table (i.e.: Subscription).

  • Constructor Summary

    Constructors
    Constructor
    Description
    SubscriptionStatistics(long totRealTime, long totLost, long totFiltered)
    Used by Lightstreamer to create a SubscriptionStatistics instance, collecting various activity statistics for a single Item.

  • Method Summary

    Modifier and Type
    Method
    Description
    long
    getTotFiltered()
    Returns the number of updates that were not sent to the client, but filtered out according to the filtering rules, throughout the life of a subscription.
    long
    getTotLost()
    Returns the number of updates that had to be sent the client, but weren't, throughout the life of a subscription.
    long
    getTotRealTime()
    Returns the number of real-time updates sent to the client throughout the life of a subscription.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • SubscriptionStatistics

      public SubscriptionStatistics(long totRealTime, long totLost, long totFiltered)
      Used by Lightstreamer to create a SubscriptionStatistics instance, collecting various activity statistics for a single Item.
      Parameters:
      totRealTime - the number of real-time updates sent to the client. Events that are part of the initial snapshot are not included.
      totLost - the number of updates that had to be sent the client, but weren't, because of buffer restrictions.
      totFiltered - the number of updates that were not sent to the client, but filtered out according to the filtering rules.

  • Method Details

    • getTotRealTime

      public long getTotRealTime()
      Returns the number of real-time updates sent to the client throughout the life of a subscription. Events that are part of the initial snapshot are not included.
      Returns:
      The number of updates sent.

    • getTotLost

      public long getTotLost()
      Returns the number of updates that had to be sent the client, but weren't, throughout the life of a subscription. This is only possible in case of buffer restrictions posed for safety purpose.
      This applies to Items subscribed to in RAW mode, or in any mode with unfiltered dispatching specified. This also applies to items subscribed to in COMMAND mode with filtered dispatching, restricted to "ADD" and "DELETE" events only (note that those events can also be filtered through matching). Any lost event is also notified to the client.
      Returns:
      The number of updates lost.

    • getTotFiltered

      public long getTotFiltered()
      Returns the number of updates that were not sent to the client, but filtered out according to the filtering rules, throughout the life of a subscription.
      Events can be filtered only if this is allowed by the item subscription mode; in that case, no information on the current state of the item is lost and the client is not notified. Events lost as specified for getTotLost() are not considered as filtered. Events discarded because of the application of a "selector" are also included in this count, regardless of the subscription mode.
      Returns:
      The number of updates filtered out.