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
|
/* -*- C++ -*- */
//=============================================================================
/**
* @file PG_Property_Set.h
*
* $Id$
*
* This file declares classes to help manage the Properties
* defined in the Portable Object Group.
*
* Note: this started as a simple helper class to make decoding sets of properties
* easier, but expanded to provide more general support for managing sets of properties.
*
* A more appropriate name would be PG_Properties_Set. Maybe this can be changed someday.
*
* @author Dale Wilson <wilson_d@ociweb.com>
*/
//=============================================================================
#ifndef TAO_PG_PROPERTY_SET
#define TAO_PG_PROPERTY_SET
#include /**/ "ace/pre.h"
#include "portablegroup_export.h"
#include "orbsvcs/orbsvcs/PortableGroupS.h"
#include "orbsvcs/orbsvcs/CosNamingC.h"
#include "ace/Hash_Map_Manager.h"
#include "ace/SString.h"
#include "ace/Null_Mutex.h"
namespace TAO
{
/**
* The PG_Property_Set captures the set of properties from a
* PortableGroup::Properties structure in a more usable format (a
* hash map), and provides methods for operating on these properties.
*
* It supports "chains" of property sets to implement default value semantics.
* If a requested property is not found in this set, the default set(s) are searched.
* Thus, any property found at this level overrides the defaults.
*
* See: PG_Properties_Support for more details on use of this object.
*
* A PG_Property_Set may also be used for it's original purpose as a stand-alone
* helper class for extracting values from PortableGroup::Properties.
*/
class TAO_PortableGroup_Export PG_Property_Set
{
typedef ACE_Hash_Map_Manager<
ACE_CString,
const PortableGroup::Value *,
ACE_SYNCH_NULL_MUTEX> ValueMap;
typedef ACE_Hash_Map_Iterator<
ACE_CString,
const PortableGroup::Value *,
ACE_SYNCH_NULL_MUTEX> ValueMapIterator;
public:
/**
* constructor: empty set with no defaults.
*/
PG_Property_Set (void);
/**
* constructor
* @param property_set the properties to be decoded
*/
PG_Property_Set (const PortableGroup::Properties & property_set
ACE_ENV_ARG_DECL_WITH_DEFAULTS)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* constructor with defaults
* @param property_set the properties to be decoded
* @param defaults a propert set decoder that supplies default values.
*/
PG_Property_Set (const PortableGroup::Properties & property_set,
PG_Property_Set * defaults
ACE_ENV_ARG_DECL_WITH_DEFAULTS)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* constructor with defaults, but no properties (yet)
* (note this is not a copy constructor)
* @param defaults a propert set decoder that supplies default values.
*/
PG_Property_Set (PG_Property_Set * defaults);
~PG_Property_Set ();
/**
* general purpose find. returns a pointer to an Any
* if templated methods were available:
* template <typename TYPE >
* int find (const ACE_CString & key, TYPE & value) const;
* instead, see global function below
* @param key the (simple) name of the property
* @param pValue an out parameter to receive a pointer to the Any containing the value
* @returns boolean true if found
*/
int find (const ACE_CString & key, const PortableGroup::Value *& pValue)const;
/**
* Decode additional properties
* Duplicate values replace previous values.
* @param property_set the properties to be decoded
*/
void decode (const PortableGroup::Properties & property_set ACE_ENV_ARG_DECL)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* Clear properties
* Does not clear default properties.
*/
void clear ();
void remove (const PortableGroup::Properties & property_set)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* set or replace a single property
*/
void set_property (
const char * name,
const PortableGroup::Value & value
ACE_ENV_ARG_DECL);
/**
* Export the properties to a PortableGroup::Properties
*
* This method is intended to be used to implement the PropertyManager::get_*_properties
* methods. If you want to access the properties for any purpose other than exporting
* them across a CORBA interface, it is much more efficient to use the find interface.
*
*/
void export_properties(PortableGroup::Properties & property_set) const;
/////////////////////////
// Implementation Methods
private:
/**
* populate a ValueMap with the properties known to this decoder
* including but overriding default values
*/
void merge_properties (ValueMap & merged_values) const;
////////////////////
// Forbidden methods
private:
PG_Property_Set(const PG_Property_Set & rhs);
PG_Property_Set & operator = (const PG_Property_Set & rhs);
///////////////
// Data Members
private:
/**
* Protect internal state.
*/
mutable TAO_SYNCH_MUTEX internals_;
ValueMap values_;
/**
* a parent to another property decoder that provides default values
* these can be chained indefinitely.
* @@ TODO: reference counted pointers would be a good idea here.
*/
PG_Property_Set * defaults_;
};
#ifdef PG_PS_UNIT_TEST
/**
* unit test: encode and decode properties.
* Initialize CORBA before calling this function.
* Success is silent, failure prints on cerr.
* @returns 1 if test passed; 0 if test failed.
*/
int test_encode_decode();
#endif // PG_PS_UNIT_TEST
} //namespace TAO
////////////////////////////////////
// include templated helper function
#include "PG_Property_Set_Find.h"
#include /**/ "ace/post.h"
#endif // TAO_PG_PROPERTY_SET
|
