83 lines
2.5 KiB
C++
83 lines
2.5 KiB
C++
/**
|
|
* @file include/ActivOneApi/ISubscriptionHandler.h
|
|
*
|
|
* @brief Header for the ISubscriptionHandler class.
|
|
*/
|
|
|
|
#if (!defined ACTIV_ONE_API_ISUBSCRIPTION_HANDLER_H)
|
|
#define ACTIV_ONE_API_ISUBSCRIPTION_HANDLER_H
|
|
|
|
#include "ActivOneApi/External.h"
|
|
|
|
#include "ActivOneApi/TypeDefinitions.h"
|
|
|
|
//! Activ namespace.
|
|
namespace Activ
|
|
{
|
|
|
|
//! OneApi namespace.
|
|
namespace OneApi
|
|
{
|
|
|
|
class Context;
|
|
class RefreshMessage;
|
|
class SubscriptionStatusMessage;
|
|
class TopicStatusMessage;
|
|
class UpdateMessage;
|
|
|
|
//! Subscription handler interface (see Session::Subscribe() and Session::QuerySubscribe()).
|
|
class ISubscriptionHandler
|
|
{
|
|
public:
|
|
//! Destructor.
|
|
virtual ~ISubscriptionHandler() { }
|
|
|
|
/**
|
|
* @brief Callback on a subscription refresh message.
|
|
*
|
|
* For map subscriptions, a refresh message is received for each entry in the map. Any number of refreshes can be
|
|
* received, including none at all for an empty map. Users should watch for a topic status of OK to detect when
|
|
* refreshes for the map have completed.
|
|
*
|
|
* @param message the @a RefreshMessage object.
|
|
* @param context the context for this event.
|
|
*/
|
|
virtual void OnSubscriptionRefresh(const RefreshMessage &message, const Context &context) { }
|
|
|
|
/**
|
|
* @brief Callback on a subscription update message.
|
|
*
|
|
* For field list subscriptions, update messages will be received after the initial refresh message.
|
|
*
|
|
* For map subscriptions, updates are received for individual entries. Update messages can be received for individual entries
|
|
* before all refresh messages have been received. Therefore, the user should expect to see update messages for individual
|
|
* entries in all subscription states other than TOPIC_SUBSCRIPTION_STATE_PENDING.
|
|
*
|
|
* @param message the @a UpdateMessage object.
|
|
* @param context the context for this event.
|
|
*/
|
|
virtual void OnSubscriptionUpdate(const UpdateMessage &message, const Context &context) { }
|
|
|
|
/**
|
|
* @brief Callback on subscription topic status message.
|
|
*
|
|
* @param message the @a TopicStatusMessage object.
|
|
* @param context the context for this event.
|
|
*/
|
|
virtual void OnSubscriptionTopicStatus(const TopicStatusMessage &message, const Context &context) { }
|
|
|
|
/**
|
|
* @brief Callback on subscription status message.
|
|
*
|
|
* @param message the @a SubscriptionStatusMessage object.
|
|
* @param context the context for this event.
|
|
*/
|
|
virtual void OnSubscriptionStatus(const SubscriptionStatusMessage &message, const Context &context) { }
|
|
};
|
|
|
|
} // namespace OneApi
|
|
|
|
} // namespace Activ
|
|
|
|
#endif // (!defined ACTIV_ONE_API_ISUBSCRIPTION_HANDLER_H)
|