Public Types |
typedef TAO_Service_Offer_Iterator<
LOCK_TYPE > | offer_iterator |
typedef ACE_Hash_Map_Manager_Ex<
TAO_String_Hash_Key, Offer_Map_Entry *,
ACE_Hash< TAO_String_Hash_Key >,
ACE_Equal_To< TAO_String_Hash_Key >,
ACE_Null_Mutex > | Offer_Database |
Public Methods |
| TAO_Offer_Database (void) |
| No arg constructor. More...
|
| ~TAO_Offer_Database (void) |
CosTrading::OfferId | insert_offer (const char *type, CosTrading::Offer *offer) |
| Add an offer of type <type> and generate a CosTrading::OfferId for it. Returns 0 on failure. More...
|
int | remove_offer (const CosTrading::OfferId offer_id ACE_ENV_ARG_DECL) throw (CosTrading::IllegalOfferId, CosTrading::UnknownOfferId) |
CosTrading::Offer * | lookup_offer (const CosTrading::OfferId offer_id ACE_ENV_ARG_DECL) throw (CosTrading::IllegalOfferId, CosTrading::UnknownOfferId) |
| Lookup an offer whose offer_id is <offer_id>, and return it. Otherwise, throw the appropriate exception. More...
|
CosTrading::Offer * | lookup_offer (const CosTrading::OfferId offer_id, char *&type_name ACE_ENV_ARG_DECL) throw (CosTrading::IllegalOfferId, CosTrading::UnknownOfferId) |
| Lookup an offer whose OfferId is <offer_id> and return in <type_name> the type name of the object. More...
|
TAO_Offer_Id_Iterator * | retrieve_all_offer_ids (void) |
| Return an iterator that will traverse and return all the offer ids in the service type map. More...
|
Private Methods |
CosTrading::Offer * | lookup_offer (const char *type, CORBA::ULong id) |
| Lookup an offer whose type is <type> and id, <id>. Return 0 on failure. More...
|
int | remove_offer (const char *type, CORBA::ULong id) |
| Remove an offers whose id is <offer_id>. More...
|
void | operator= (const TAO_Offer_Database< LOCK_TYPE > &) |
| TAO_Offer_Database (const TAO_Offer_Database< LOCK_TYPE > &) |
Static Private Methods |
CosTrading::OfferId | generate_offer_id (const char *type_name, CORBA::ULong id) |
| Take in a service type name for the offer the current value of of the counter and generate an offer id. More...
|
void | parse_offer_id (const CosTrading::OfferId offer_id, char *&service_type, CORBA::ULong &id ACE_ENV_ARG_DECL) throw (CosTrading::IllegalOfferId) |
| Take in a previously generated offer id and return the type and id that were used to generate the offer id. More...
|
Private Attributes |
LOCK_TYPE | db_lock_ |
Offer_Database | offer_db_ |
Friends |
class | TAO_Service_Offer_Iterator< LOCK_TYPE > |
The underlying structure is a map of maps. The first maps maps the service type name to a map of exported offers. The second map maps the identifying index for that offer within the service types. So a service type name and an index uniquely identifies an exported offer. In fact, when the register export interface returns a CosTrading::OfferId, it's returning no more than a simple string concatenation of these two values. In addition to all these wonderful things, the TAO_Offer_Database has built-in locking, one reader/writer-style lock for modifying the top-level map and a reader/writer-style for each of the offer maps. Needless to say the locks are acquired when the TAO_Offer_Database performs operations on the structures they guard. NOTE: TAO_Offer_Database needs to be parameterized by a READER/WRITER LOCK, a RECURSIVE MUTEX, or a NULL MUTEX, not a simple binary mutex! Mutexes will cause deadlock when you try to contruct an iterator (which acquires a read lock on the map under an existing read lock). Just don't do it, ok?