#include <PG_Properties_Support.h>
Collaboration diagram for TAO::PG_Properties_Support:
One set, default_properties_, acts as a "global" default set of properties.
The collection, properties_map_, contains a set of properties for each PortableGroup::type_id. The default set acts as a "parent" for each of these type_id sets.
Expected use: When an object group is created that implements the interface identified by type_id, the corresponding typed_id propery set acts as a parent to the Property set contained in the PG_Object_Group.
This heirarchy of property sets provides the correct property behavior. A request for a propery to an ObjectGroup will be satisfied from: by the object group group property set, or the typed_id property set, or the default property set, or the request will fail..
Note that changes to type_id or default properties will be visible immediately at the ObjectGroup level.
Definition at line 53 of file PG_Properties_Support.h.
|
|
Definition at line 58 of file PG_Properties_Support.h. |
|
|
Definition at line 62 of file PG_Properties_Support.h. |
|
|
Definition at line 19 of file PG_Properties_Support.cpp.
00020 {
00021 }
|
|
|
Definition at line 23 of file PG_Properties_Support.cpp.
00024 {
00025
00026 }
|
|
|
Export the property set in a PortableGroup::Properties format. This method is intended to provide a parent for the property set in a newly-created Object Group of the given type_id. Callers who intend to send the property set across a CORBA interface should use the get_type_properties method.
Definition at line 112 of file PG_Properties_Support.cpp. References ACE_GUARD_RETURN, ACE_NEW_THROW_EX, ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::bind(), ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::find(), properties_map_, and TAO_SYNCH_MUTEX.
00114 {
00115 ACE_GUARD_RETURN (TAO_SYNCH_MUTEX, guard, this->internals_, 0);
00116
00117 TAO::PG_Property_Set * typeid_properties = 0;
00118 if ( 0 != this->properties_map_.find (type_id, typeid_properties))
00119 {
00120 ACE_NEW_THROW_EX (
00121 typeid_properties,
00122 TAO::PG_Property_Set (& this->default_properties_),
00123 CORBA::NO_MEMORY());
00124 this->properties_map_.bind (type_id, typeid_properties);
00125 }
00126 return typeid_properties;
00127 }
|
|
|
Export the default properties in PortableGroup::Properties format. This produces the properties in a format suitable for use across a CORBA interface. The caller owns the resulting Properties and must release it to avoid resource leaks.
Definition at line 40 of file PG_Properties_Support.cpp. References ACE_NEW_THROW_EX, default_properties_, TAO::PG_Property_Set::export_properties(), and PortableGroup::Properties.
00041 {
00042 PortableGroup::Properties_var result;
00043 ACE_NEW_THROW_EX ( result, PortableGroup::Properties(), CORBA::NO_MEMORY());
00044 this->default_properties_.export_properties (*result);
00045 return result._retn ();
00046 }
|
|
|
Export the property set in a PortableGroup::Properties format. This produces the properties associated with a type_id -- including any default properties that have not been overridden at the type_id level in a format suitable for use across a CORBA interface. The caller owns the resulting Properties and must release it to avoid resource leaks. Compare this method to find_typeid_properties which returns a pointer to the internal representation of the properties in TAO::PG_Property_Set format. This is more efficient, but suitable only for internal use.
Definition at line 75 of file PG_Properties_Support.cpp. References ACE_GUARD_RETURN, ACE_NEW_THROW_EX, TAO::PG_Property_Set::export_properties(), ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::find(), PortableGroup::Properties, properties_map_, and TAO_SYNCH_MUTEX.
00077 {
00078 PortableGroup::Properties_var result;
00079 ACE_NEW_THROW_EX (result, PortableGroup::Properties(), CORBA::NO_MEMORY ());
00080
00081 ACE_GUARD_RETURN (TAO_SYNCH_MUTEX, guard, this->internals_, 0);
00082
00083 TAO::PG_Property_Set * typeid_properties = 0;
00084 if ( 0 != this->properties_map_.find (type_id, typeid_properties))
00085 {
00086 typeid_properties->export_properties (*result);
00087 }
00088 return result._retn ();
00089 }
|
|
|
Undefine default properties that appear in props. Properties that are defined in props are removed from the default property set. Removal is done by name. The property values do not have to match. There is no penalty for attempting to remove a property that does not exist.
Definition at line 48 of file PG_Properties_Support.cpp. References default_properties_, PortableGroup::Properties, and TAO::PG_Property_Set::remove().
00050 {
00051 this->default_properties_.remove (props);
00052 }
|
|
||||||||||||
|
Undefine default properties that appear in props. Properties that are defined in props are removed from the type_id property set. Removal is done by name. The property values do not have to match. There is no penalty for attempting to remove a property that does not exist.
Definition at line 92 of file PG_Properties_Support.cpp. References ACE_GUARD, ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::find(), PortableGroup::Properties, properties_map_, TAO::PG_Property_Set::remove(), and TAO_SYNCH_MUTEX.
00095 {
00096 // NOTE: do not actually delete the properties for this type.
00097 // There may be object groups depending on these.
00098 // Reference counted pointers could be used to allow property sets
00099 // for unused typeids to be deleted.
00100
00101 ACE_GUARD (TAO_SYNCH_MUTEX, guard, this->internals_);
00102
00103 TAO::PG_Property_Set * typeid_properties = 0;
00104 if ( 0 != this->properties_map_.find (type_id, typeid_properties))
00105 {
00106 typeid_properties->remove (props);
00107 }
00108 }
|
|
|
Update the default property set. Properties that appear in props are replaced in or added to the default property set. Properties that do not appear in props are unchanged.
Definition at line 34 of file PG_Properties_Support.cpp. References TAO::PG_Property_Set::decode(), default_properties_, and PortableGroup::Properties.
00035 {
00036 this->default_properties_.decode (props);
00037 }
|
|
||||||||||||
|
Set a single default property. Overwriting any value previously set for that property. Leaving all other properties untouched.
Definition at line 28 of file PG_Properties_Support.cpp. References default_properties_, TAO::PG_Property_Set::set_property(), and PortableGroup::Value.
00030 {
00031 this->default_properties_.set_property(name, value);
00032 }
|
|
||||||||||||
|
Override or define properties associated with a type_id. If a property set does not exist for type_id, a new one will be created. Any property included in overrides will be set or replaced in the type_id property set. Any property not in overrides will be unchanged. Contrary to the "throws" specification, this method does not attempt to validate the properties because doing so would unnecessarily constrain the uses to which this class could be put (although one could strategize the validation.) Definition at line 55 of file PG_Properties_Support.cpp. References ACE_GUARD, ACE_NEW_THROW_EX, ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::bind(), TAO::PG_Property_Set::clear(), TAO::PG_Property_Set::decode(), ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, ACE_Hash< EXT_ID >, ACE_Equal_To< EXT_ID >, ACE_LOCK >::find(), PortableGroup::Properties, properties_map_, and TAO_SYNCH_MUTEX.
00058 {
00059 ACE_GUARD (TAO_SYNCH_MUTEX, guard, this->internals_);
00060
00061 TAO::PG_Property_Set * typeid_properties;
00062 if ( 0 != this->properties_map_.find (type_id, typeid_properties))
00063 {
00064 ACE_NEW_THROW_EX (
00065 typeid_properties,
00066 TAO::PG_Property_Set (overrides, & this->default_properties_),
00067 CORBA::NO_MEMORY());
00068 this->properties_map_.bind (type_id, typeid_properties);
00069 }
00070 typeid_properties->clear ();
00071 typeid_properties->decode (overrides);
00072 }
|
|
|
The default property set.
Definition at line 185 of file PG_Properties_Support.h. Referenced by get_default_properties(), remove_default_properties(), set_default_properties(), and set_default_property(). |
|
|
Protect internal state. Definition at line 182 of file PG_Properties_Support.h. |
|
|
A collection of property sets indexed by type_id.
Definition at line 188 of file PG_Properties_Support.h. Referenced by find_typeid_properties(), get_type_properties(), remove_type_properties(), and set_type_properties(). |
1.3.6