Files
externals/linux/include/ActivOneApi/ISubscriptionHandler.h
T
2023-12-15 13:15:08 -05:00

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)