TAO_Property_Evaluator_By_Name Class Reference

This class extends the TAO_Property_Evaluator to allow lookups based on the property name of interest. Since the property information is contained within an integer indexed array, lookups may occur in O(n) time, where n is the length of the array. To make lookups by name more efficient, TAO_Property_Evaluator_By_Name creates a mapping of property names to integer indicies, upon which lookups are guaranteed to be O(lg n). More...

#include <Trader_Utils.h>

Inheritance diagram for TAO_Property_Evaluator_By_Name:

[legend]Collaboration diagram for TAO_Property_Evaluator_By_Name:

[legend]List of all members.

Public Member Functions
	TAO_Property_Evaluator_By_Name (const CosTrading::PropertySeq &properties, CORBA::Boolean supports_dp=1) throw (CosTrading::DuplicatePropertyName, CosTrading::IllegalPropertyName)
	TAO_Property_Evaluator_By_Name (CosTrading::Offer &offer, CORBA::Boolean supports_dp=1)
int	is_dynamic_property (const char *property_name)
CORBA::Any *	property_value (const char *property_name) throw (CosTradingDynamic::DPEvalFailure)
CORBA::TypeCode_ptr	property_type (const char *property_name)
const CosTrading::Property *	get_property (const char *property_name)
Private Member Functions
	TAO_Property_Evaluator_By_Name (const TAO_Property_Evaluator_By_Name &)
TAO_Property_Evaluator_By_Name &	operator= (const TAO_Property_Evaluator_By_Name &)
Private Attributes
TAO_Lookup_Table	table_

---

Detailed Description

This class extends the TAO_Property_Evaluator to allow lookups based on the property name of interest. Since the property information is contained within an integer indexed array, lookups may occur in O(n) time, where n is the length of the array. To make lookups by name more efficient, TAO_Property_Evaluator_By_Name creates a mapping of property names to integer indicies, upon which lookups are guaranteed to be O(lg n).

Definition at line 126 of file Trader_Utils.h.

---

Constructor & Destructor Documentation

TAO_Property_Evaluator_By_Name::TAO_Property_Evaluator_By_Name (  const CosTrading::PropertySeq &  properties, CORBA::Boolean  supports_dp = 1 )  throw (CosTrading::DuplicatePropertyName, CosTrading::IllegalPropertyName)

Definition at line 342 of file Trader_Utils.cpp. References ACE_THROW, TAO_Trader_Base::is_valid_property_name(), CosTrading::Property::name, and CosTrading::PropertySeq. : TAO_Property_Evaluator (properties, supports_dp) { int length = this->props_.length(); for (int i = 0; i < length; i++) { const CosTrading::Property& prop = this->props_[i]; if (! TAO_Trader_Base::is_valid_property_name (prop.name)) ACE_THROW (CosTrading::IllegalPropertyName (prop.name)); CORBA::String_var prop_name = prop.name.in (); if (this->table_.bind (prop_name, i)) ACE_THROW (CosTrading::DuplicatePropertyName (prop.name)); } }

TAO_Property_Evaluator_By_Name::TAO_Property_Evaluator_By_Name (  CosTrading::Offer &  offer, CORBA::Boolean  supports_dp = 1 )

Construct an instance of TAO_Property_Evaluator that operates on an where the support for dynamic properties is dictated by . Definition at line 365 of file Trader_Utils.cpp. References ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, HASH_KEY, COMPARE_KEYS, ACE_LOCK >::bind(). : TAO_Property_Evaluator(offer, supports_dp) { int length = this->props_.length(); for (int i = 0; i < length; i++) { CORBA::String_var prop_name = (const char*) this->props_[i].name; this->table_.bind (prop_name, i); } }

TAO_Property_Evaluator_By_Name::TAO_Property_Evaluator_By_Name (  const TAO_Property_Evaluator_By_Name &   )  [private]

---

Member Function Documentation

const CosTrading::Property * TAO_Property_Evaluator_By_Name::get_property (  const char *  property_name  )

Definition at line 432 of file Trader_Utils.cpp. References ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, HASH_KEY, COMPARE_KEYS, ACE_LOCK >::find(). Referenced by TAO_Register< TRADER_LOCK_TYPE, MAP_LOCK_TYPE >::validate_properties(). { int index = 0; CosTrading::Property* property = 0; CORBA::String_var prop_name (property_name); if (this->table_.find (prop_name, index) == 0) property = (CosTrading::Property *) &this->props_[index]; return property; }

int TAO_Property_Evaluator_By_Name::is_dynamic_property (  const char *  property_name  )

Returns 1 if the property whose name is is defined and dynamic. If the property is undefined, this method will throw a Property_Undefined exception with impunity. Definition at line 380 of file Trader_Utils.cpp. References ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, HASH_KEY, COMPARE_KEYS, ACE_LOCK >::find(), and TAO_Property_Evaluator::is_dynamic_property(). Referenced by TAO_Register< TRADER_LOCK_TYPE, MAP_LOCK_TYPE >::validate_properties(). { int predicate = 0; int index = 0; CORBA::String_var prop_name (property_name); // If the property name is in the map, delegate evaluation to our // superclass. Otherwise, throw an exception. if (this->table_.find (prop_name, index) == 0) predicate = this->TAO_Property_Evaluator::is_dynamic_property(index); return predicate; }

TAO_Property_Evaluator_By_Name& TAO_Property_Evaluator_By_Name::operator= (  const TAO_Property_Evaluator_By_Name &   )  [private]

CORBA::TypeCode_ptr TAO_Property_Evaluator_By_Name::property_type (  const char *  property_name  )

This method is identical to its counterpart in TAO_Property_Evaluator, exception property_type first discovers the index through a string matching lookup. Definition at line 417 of file Trader_Utils.cpp. References ACE_Hash_Map_Manager_Ex< EXT_ID, INT_ID, HASH_KEY, COMPARE_KEYS, ACE_LOCK >::find(), and TAO_Property_Evaluator::property_type(). Referenced by TAO_Register< TRADER_LOCK_TYPE, MAP_LOCK_TYPE >::validate_properties(). { int index = 0; CORBA::String_var prop_name (property_name); CORBA::TypeCode_ptr prop_type = CORBA::TypeCode::_nil(); // If the property name is in the map, delegate evaluation to our // superclass. Otherwise, throw an exception. if (this->table_.find (prop_name, index) == 0) prop_type = this->TAO_Property_Evaluator::property_type (index); return prop_type; }

CORBA::Any * TAO_Property_Evaluator_By_Name::property_value (  const char *  property_name  )  throw (CosTradingDynamic::DPEvalFailure)

This method is identical to its counterpart in TAO_Property_Evaluator, except property_value first discovers the index through a string matching lookup. Definition at line 395 of file Trader_Utils.cpp. References ACE_CHECK_RETURN, ACE_ENV_ARG_PARAMETER, and TAO_Property_Evaluator::property_value(). { int index = 0; CORBA::Any* prop_value = 0; CORBA::String_var prop_name (property_name); // If the property name is in the map, delegate evaluation to our // superclass. Otherwise, throw an exception. if (this->table_.find (prop_name, index) == 0) { prop_value = this->TAO_Property_Evaluator::property_value (index ACE_ENV_ARG_PARAMETER); ACE_CHECK_RETURN (0); } return prop_value; }

---

Member Data Documentation

TAO_Lookup_Table TAO_Property_Evaluator_By_Name::table_ [private]

The instance of the above mapping for the offer provided in the constructor. Definition at line 176 of file Trader_Utils.h.

---

The documentation for this class was generated from the following files:

• Trader_Utils.h
• Trader_Utils.cpp

---