istatecallback.h
3.98 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
#ifndef OSDEV_COMPONENTS_MQTT_ISTATECALLBACK_H
#define OSDEV_COMPONENTS_MQTT_ISTATECALLBACK_H
// std
#include <ostream>
// boost
#include <boost/signals2.hpp>
namespace osdev {
namespace components {
namespace mqtt {
/*!
* \brief Struct introduces a typed client identifier.
*/
struct ClientIdentifier
{
/*!
* \brief Construct a ClientIdentifier
* \param id The client id. Default is empty.
*/
explicit ClientIdentifier(const std::string& id = "")
: m_id(id)
{
}
const std::string m_id; ///< Client identifier
};
/*!
* \brief Enumeration of state codes.
* The states Unknown, CommunicationFailure, GeneralFailure, Good
* and Shutdown are used to communicate state about the server
* that is connected to. The states ConnectionFailure and Unregister
* communicate state about the client.
*/
enum class StateEnum
{
Unknown, ///< State of underlying data source is unknown.
CommunicationFailure, ///< No communication with underlying data source.
GeneralFailure, ///< Some failure in the underlying data source.
Good, ///< Underlying data source is available.
Shutdown, ///< Underlying data source is shutting down.
ConnectionFailure, ///< Client connection has failed.
Unregister ///< Client is being unregistered.
};
/*!
* \brief Stream a StateEnum value
*/
std::ostream& operator<<(std::ostream& os, StateEnum rhs);
/*!
* \brief Type for identifying state change callbacks.
*/
using StateChangeCallbackHandle = std::uint32_t;
class IStateCallback;
/*!
* \brief Create an id for an IStateCallback object.
* \param idStatic - Static part of the id (name of the class).
* \param clientId - Client identifier. Can contain information on how
* the client is used for instance. If the id is empty
* it is not used.
* \param idDynamic - Dynamic part (object address).
* \return identifier as string
*/
std::string createIdentifier(const std::string& idStatic, const ClientIdentifier& clientId, const IStateCallback* idDynamic);
/*!
* \brief State callback interface.
* When a client implements this interface it can be registered on a
* server in order to handle state changes from the underlying data source.
* \note When the client is destroyed it is expected that it unregisters itself by calling
* clearAllStateChangeCallbacks().
*/
class IStateCallback
{
public:
using SigStateChange = boost::signals2::signal<void(const IStateCallback*, StateEnum)>;
using SlotStateChange = SigStateChange::slot_type;
virtual ~IStateCallback();
/*!
* \brief Get a string that identifies this interface.
*/
virtual std::string clientId() const = 0;
/*!
* \brief Register a callback function that is called when the status changes.
* \param cb - The callback function to register.
* \return handle to the registered callback.
* \note Make sure that the callback function lives longer than the IStateCallback object.
* Otherwise unregister callback function before it is destroyed.
*/
virtual StateChangeCallbackHandle registerStateChangeCallback(const SlotStateChange& cb) = 0;
/*!
* \brief Unregister a previously registered callback function.
* If the callback function was not registered nothing happens.
* \param handle - Identifies the callback function to to unregister.
*/
virtual void unregisterStateChangeCallback(StateChangeCallbackHandle handle) = 0;
/*!
* \brief Remove all the registered callback functions.
*/
virtual void clearAllStateChangeCallbacks() = 0;
/*!
* \brief retuns the latest state received.
*/
virtual StateEnum state() const = 0;
};
} // End namespace mqtt
} // End namespace components
} // End namespace osdev
#endif // OSDEV_COMPONENTS_MQTT_ISTATECALLBACK_H