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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
|
/*****************************************************************
|
| Platinum - Service State Variable
|
| Copyright (c) 2004-2010, Plutinosoft, LLC.
| All rights reserved.
| http://www.plutinosoft.com
|
| This program is free software; you can redistribute it and/or
| modify it under the terms of the GNU General Public License
| as published by the Free Software Foundation; either version 2
| of the License, or (at your option) any later version.
|
| OEMs, ISVs, VARs and other distributors that combine and
| distribute commercially licensed software with Platinum software
| and do not wish to distribute the source code for the commercially
| licensed software under version 2, or (at your option) any later
| version, of the GNU General Public License (the "GPL") must enter
| into a commercial license agreement with Plutinosoft, LLC.
| licensing@plutinosoft.com
|
| This program is distributed in the hope that it will be useful,
| but WITHOUT ANY WARRANTY; without even the implied warranty of
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
| GNU General Public License for more details.
|
| You should have received a copy of the GNU General Public License
| along with this program; see the file LICENSE.txt. If not, write to
| the Free Software Foundation, Inc.,
| 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
| http://www.gnu.org/licenses/gpl-2.0.html
|
****************************************************************/
/** @file
UPnP State Variable
*/
#ifndef _PLT_STATE_VARIABLE_H_
#define _PLT_STATE_VARIABLE_H_
/*----------------------------------------------------------------------
| includes
+---------------------------------------------------------------------*/
#include "Neptune.h"
/*----------------------------------------------------------------------
| forward declarations
+---------------------------------------------------------------------*/
class PLT_Argument;
class PLT_Service;
/*----------------------------------------------------------------------
| NPT_AllowedValueRange struct
+---------------------------------------------------------------------*/
/**
The NPT_AllowedValueRange struct holds the min, max and step value allowed of
a UPnP Service state variable.
*/
typedef struct {
NPT_Int32 min_value;
NPT_Int32 max_value;
NPT_Int32 step;
} NPT_AllowedValueRange;
/*----------------------------------------------------------------------
| PLT_StateVariable class
+---------------------------------------------------------------------*/
/**
The PLT_StateVariable class maintains the state of a UPnP Service state variable.
It is used by a PLT_DeviceHost instance to notify subscribers of a change or by a
subscriber (PLT_CtrlPoint) when a service state variable change notification
has been received.
*/
class PLT_StateVariable
{
public:
PLT_StateVariable(PLT_Service* service);
~PLT_StateVariable();
/**
Populate the SCPD xml document with state variable information.
@param node XML Element where to insert the state variable XML Element
*/
NPT_Result GetSCPDXML(NPT_XmlElementNode* node);
/**
Return the PLT_Service that this state variable is associated with.
@return PLT_Service pointer.
*/
PLT_Service* GetService();
/**
Return whether the state variable is eventable directly or indirectly. A state
variable sends events indirectly when part of the "LastChange" state variable.
@param indirectly Boolean to test if the state variable is sending events indirectly
@return Whether the state variable sends events according to the input flag specified.
*/
bool IsSendingEvents(bool indirectly = false);
/**
Force the state variable to send events directly.
*/
void DisableIndirectEventing();
/**
Certain state variables notifications must not be sent faster than a certain
rate according to the UPnP specs. This sets the rate for a given state variable.
@param rate time interval to respect between notifications.
*/
NPT_Result SetRate(NPT_TimeInterval rate);
/**
Set the state variable value. The value is first validated to make sure
it is an allowed value. Once the value is validated, it is marked for eventing by
calling the PLT_Service AddChanged function.
@param value new state variable value. Can be a comma separated list of values.
@param clearonsend whether the statevariable should be cleared immediatly after sending
*/
NPT_Result SetValue(const char* value, const bool clearonsend = false);
/**
Validate the new value of the state variable.
@param value new state variable value. Can be a comma separated list of values.
*/
NPT_Result ValidateValue(const char* value);
/**
Certain state variables require extra xml attributes when serialized.
@param name the attribute name
@param value the attribute value
*/
NPT_Result SetExtraAttribute(const char* name, const char* value);
/**
Return the state variable name.
@return state variable name.
*/
const NPT_String& GetName() const { return m_Name; }
/**
Return the current state variable value.
@return state variable current value.
*/
const NPT_String& GetValue() const { return m_Value; }
/**
Return the state variable data type.
@return state variable data type.
*/
const NPT_String& GetDataType() const { return m_DataType; }
/**
Return the state variable allowed value range if any.
@return state variable value range pointer or null if none.
*/
const NPT_AllowedValueRange* GetAllowedValueRange() const { return m_AllowedValueRange; }
/**
Helper function to return a state variable given a list of state variables
and a state variable name.
@param vars list of state variables
@param name state variable name to look for
@return PLT_StateVariable pointer.
*/
static PLT_StateVariable* Find(NPT_List<PLT_StateVariable*>& vars,
const char* name);
protected:
/**
Return whether the state variable value changed and subscribers need to
be notified.
*/
bool IsReadyToPublish();
/**
* If this statevariable should clear after sending to all subscribers, clears the value without
* eventing the change
*/
void OnSendCompleted();
/**
Serialize the state variable into xml.
*/
NPT_Result Serialize(NPT_XmlElementNode& node);
protected:
friend class PLT_Service;
friend class PLT_LastChangeXMLIterator;
//members
PLT_Service* m_Service;
NPT_AllowedValueRange* m_AllowedValueRange;
NPT_String m_Name;
NPT_String m_DataType;
NPT_String m_DefaultValue;
bool m_IsSendingEvents;
bool m_IsSendingEventsIndirectly;
bool m_ShouldClearOnSend;
NPT_TimeInterval m_Rate;
NPT_TimeStamp m_LastEvent;
NPT_Array<NPT_String*> m_AllowedValues;
NPT_String m_Value;
NPT_Map<NPT_String,NPT_String> m_ExtraAttributes;
};
/*----------------------------------------------------------------------
| PLT_StateVariableNameFinder
+---------------------------------------------------------------------*/
/**
The PLT_StateVariableNameFinder class returns the PLT_StateVariable instance
given a state variable name.
*/
class PLT_StateVariableNameFinder
{
public:
// methods
PLT_StateVariableNameFinder(const char* name) : m_Name(name) {}
virtual ~PLT_StateVariableNameFinder() {}
bool operator()(const PLT_StateVariable* const & state_variable) const {
return state_variable->GetName().Compare(m_Name, true) ? false : true;
}
private:
// members
NPT_String m_Name;
};
#endif /* _PLT_STATE_VARIABLE_H_ */
|
