|
TAO_CosNaming
2.1.0
|
Provides hash-table-based persistent storage for name to object bindings in a Naming Context. More...
#include <Persistent_Naming_Context.h>


Public Types | |
| typedef ACE_Hash_Map_With_Allocator < TAO_Persistent_ExtId, TAO_Persistent_IntId > | HASH_MAP |
| Underlying data structure - typedef for ease of use. | |
Public Member Functions | |
| TAO_Persistent_Bindings_Map (CORBA::ORB_ptr orb) | |
| Constructor. | |
| int | open (size_t hash_map_size, ACE_Allocator *alloc) |
| void | set (HASH_MAP *map, ACE_Allocator *alloc) |
| virtual | ~TAO_Persistent_Bindings_Map (void) |
| void | destroy (void) |
| HASH_MAP * | map (void) |
| Get a pointer to the underlying hash map. | |
| size_t | total_size (void) |
| Return the size of the underlying hash table. | |
| virtual size_t | current_size (void) |
| Return the size of the underlying hash table. | |
| virtual int | bind (const char *id, const char *kind, CORBA::Object_ptr obj, CosNaming::BindingType type) |
| virtual int | rebind (const char *id, const char *kind, CORBA::Object_ptr obj, CosNaming::BindingType type) |
| virtual int | unbind (const char *id, const char *kind) |
| virtual int | find (const char *id, const char *kind, CORBA::Object_ptr &obj, CosNaming::BindingType &type) |
Protected Member Functions | |
| int | open_helper (size_t hash_table_size, void *buffer) |
| int | shared_bind (const char *id, const char *kind, CORBA::Object_ptr obj, CosNaming::BindingType type, int rebind) |
| Helper: factors common code from <bind> and <rebind>. | |
Protected Attributes | |
| ACE_Allocator * | allocator_ |
| Pointer to the allocator we use to make bindings persistent. | |
| HASH_MAP * | map_ |
| Pointer to the underlying hash map. | |
| CORBA::ORB_var | orb_ |
| Pointer to the orb. We need it to do string/object conversions. | |
Provides hash-table-based persistent storage for name to object bindings in a Naming Context.
Wrapper on top of ACE_Hash_Map_With_Allocator (which is a wrapper around ACE_Hash_Map_Manager). Uses ACE_Allocator (allocating from persistent storage) to make bindings persistent and supports TAO_Bindings_Map interface. Used by TAO_Persistent_Naming_Context.
| typedef ACE_Hash_Map_With_Allocator<TAO_Persistent_ExtId, TAO_Persistent_IntId> TAO_Persistent_Bindings_Map::HASH_MAP |
Underlying data structure - typedef for ease of use.
Constructor.
| TAO_Persistent_Bindings_Map::~TAO_Persistent_Bindings_Map | ( | void | ) | [virtual] |
Destructor. Does not deallocate the hash map: if an instance of this class goes out of scope, its hash_map remains in persistent storage.
| int TAO_Persistent_Bindings_Map::bind | ( | const char * | id, |
| const char * | kind, | ||
| CORBA::Object_ptr | obj, | ||
| CosNaming::BindingType | type | ||
| ) | [virtual] |
Add a binding with the specified parameters to the table. Return 0 on success and -1 on failure, 1 if there already is a binding with <id> and <kind>.
Implements TAO_Bindings_Map.
| size_t TAO_Persistent_Bindings_Map::current_size | ( | void | ) | [virtual] |
Return the size of the underlying hash table.
Implements TAO_Bindings_Map.
| void TAO_Persistent_Bindings_Map::destroy | ( | void | ) |
This method removes the hash map from persistent storage/frees up the memory. The hash map better be empty, since we are not cleaning up the insides. (We could add <close> to clean entries, but not the data inside the entries.
| int TAO_Persistent_Bindings_Map::find | ( | const char * | id, |
| const char * | kind, | ||
| CORBA::Object_ptr & | obj, | ||
| CosNaming::BindingType & | type | ||
| ) | [virtual] |
Find the binding containing <id> and <kind> in the table, and pass binding's type and object back to the caller by reference. Return 0 on success and -1 on failure. Note: a 'duplicated' object reference is assigned to <obj>, so the caller is responsible for its deallocation.
Implements TAO_Bindings_Map.
Get a pointer to the underlying hash map.
| int TAO_Persistent_Bindings_Map::open | ( | size_t | hash_map_size, |
| ACE_Allocator * | alloc | ||
| ) |
Allocate hash map of size <hash_map_size> from persistent storage using the <alloc>.
| int TAO_Persistent_Bindings_Map::open_helper | ( | size_t | hash_table_size, |
| void * | buffer | ||
| ) | [protected] |
Helper to the <open> method. By isolating placement new into a separate method, we can deal with memory allocation failures more efficiently. If there is a problem in HASH_MAP constructor, we can clean up preallocated space.
| int TAO_Persistent_Bindings_Map::rebind | ( | const char * | id, |
| const char * | kind, | ||
| CORBA::Object_ptr | obj, | ||
| CosNaming::BindingType | type | ||
| ) | [virtual] |
Overwrite a binding containing <id> and <kind> (or create a new one if one doesn't exist) with the specified parameters. Return 0 or 1 on success. Return -1 or -2 on failure. (-2 is returned if the new and old bindings differ in type).
Implements TAO_Bindings_Map.
| void TAO_Persistent_Bindings_Map::set | ( | HASH_MAP * | map, |
| ACE_Allocator * | alloc | ||
| ) |
The hash map has already been preallocated for us. We just need to set our data members take ownership of it.
| int TAO_Persistent_Bindings_Map::shared_bind | ( | const char * | id, |
| const char * | kind, | ||
| CORBA::Object_ptr | obj, | ||
| CosNaming::BindingType | type, | ||
| int | rebind | ||
| ) | [protected] |
Helper: factors common code from <bind> and <rebind>.
| size_t TAO_Persistent_Bindings_Map::total_size | ( | void | ) |
Return the size of the underlying hash table.
| int TAO_Persistent_Bindings_Map::unbind | ( | const char * | id, |
| const char * | kind | ||
| ) | [virtual] |
Remove a binding containing <id> and <kind> from the table. Return 0 on success and -1 on failure.
Implements TAO_Bindings_Map.
ACE_Allocator* TAO_Persistent_Bindings_Map::allocator_ [protected] |
Pointer to the allocator we use to make bindings persistent.
HASH_MAP* TAO_Persistent_Bindings_Map::map_ [protected] |
Pointer to the underlying hash map.
CORBA::ORB_var TAO_Persistent_Bindings_Map::orb_ [protected] |
Pointer to the orb. We need it to do string/object conversions.
1.8.0