com.devexperts.qd

Interface SubscriptionProvider

All Known Subinterfaces:

QDAgent, RecordProvider

All Known Implementing Classes:

AbstractRecordProvider, CompositeRecordProvider, RecordBuffer, SubscriptionBuffer

public interface SubscriptionProvider

The SubscriptionProvider allows retrieval of accumulated subscription. See SubscriptionVisitor and SubscriptionListener for description of corresponding contracts.

Legacy interface

FUTURE DEPRECATION NOTE: New code shall not implement this interface due to its complexity and inherent slowness. Extend AbstractRecordProvider or use RecordBuffer as a high-performance implementation of it when data is available in advance. New code is also discouraged from using this interface unless it is need for interoperability with legacy code. Various legacy APIs will be gradually migrated to NG interfaces and classes.

Method Summary

Modifier and Type	Method and Description
boolean	retrieveSubscription(SubscriptionVisitor visitor) Retrieves accumulated subscription into specified subscription visitor.
void	setSubscriptionListener(SubscriptionListener listener) Sets new subscription listener to receive notifications about subscription.

Method Detail

retrieveSubscription

boolean retrieveSubscription(SubscriptionVisitor visitor)

Retrieves accumulated subscription into specified subscription visitor. Returns true if some subscription still remains in the provider or false if all accumulated subscription were retrieved.

setSubscriptionListener

void setSubscriptionListener(SubscriptionListener listener)

Sets new subscription listener to receive notifications about subscription. Only one listener at a time is supported; the former listener is discarded. Use null to set empty subscription listener (no notifications).

NOTE: if there is accumulated subscription available, then specified listener will be notified by this method.