diff options
Diffstat (limited to 'ACE/ace/Hash_Map_With_Allocator_T.h')
-rw-r--r-- | ACE/ace/Hash_Map_With_Allocator_T.h | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/ACE/ace/Hash_Map_With_Allocator_T.h b/ACE/ace/Hash_Map_With_Allocator_T.h new file mode 100644 index 00000000000..1c2413ba3f2 --- /dev/null +++ b/ACE/ace/Hash_Map_With_Allocator_T.h @@ -0,0 +1,112 @@ +// -*- C++ -*- + +//============================================================================= +/** + * @file Hash_Map_With_Allocator_T.h + * + * $Id$ + * + * @author Marina Spivak <marina@cs.wustl.edu> + * @author Irfan Pyarali <irfan@cs.wustl.edu> + */ +//============================================================================= + +#ifndef ACE_HASH_MAP_WITH_ALLOCATOR_T_H +#define ACE_HASH_MAP_WITH_ALLOCATOR_T_H +#include /**/ "ace/pre.h" + +#include "ace/Hash_Map_Manager_T.h" +#include "ace/Null_Mutex.h" + +#if !defined (ACE_LACKS_PRAGMA_ONCE) +# pragma once +#endif /* ACE_LACKS_PRAGMA_ONCE */ + +ACE_BEGIN_VERSIONED_NAMESPACE_DECL + +/** + * @class ACE_Hash_Map_With_Allocator + * + * @brief This class is a thin wrapper around ACE_Hash_Map_Manager, + * which comes handy when ACE_Hash_Map_Manager is to be used with a + * non-nil ACE_Allocator. This wrapper insures that the appropriate + * allocator is in place for every operation that accesses or + * updates the hash map. + * + * If we use ACE_Hash_Map_Manager with a shared memory allocator + * (or memory-mapped file allocator, for example), the allocator + * pointer used by ACE_Hash_Map_Manager gets stored with it, in + * shared memory (or memory-mapped file). Naturally, this will + * cause horrible problems, since only the first process to set + * that pointer will be guaranteed the address of the allocator + * is meaningful! That is why we need this wrapper, which + * insures that appropriate allocator pointer is in place for + * each call. + * + * At some point it would be a good idea to update this class to + * use the new "two allocator" technique provided by @c + * ACE_Hash_Map_Manager_Ex. + */ +template <class EXT_ID, class INT_ID> +class ACE_Hash_Map_With_Allocator : + public ACE_Hash_Map_Manager_Ex<EXT_ID, INT_ID, ACE_Hash<EXT_ID>, ACE_Equal_To<EXT_ID>, ACE_Null_Mutex> +{ +public: + /// Constructor. + ACE_Hash_Map_With_Allocator (ACE_Allocator *alloc); + + /// Constructor that specifies hash table size. + ACE_Hash_Map_With_Allocator (size_t size, + ACE_Allocator *alloc); + + // = The following methods are Proxies to the corresponding methods + // in ACE_Hash_Map_Manager. Each method sets the allocator to + // the one specified by the invoking entity, and then calls the + // corresponding method in ACE_Hash_Map_Manager to do the + // actual work. + + int bind (const EXT_ID &, + const INT_ID &, + ACE_Allocator *alloc); + + int unbind (const EXT_ID &, + INT_ID &, + ACE_Allocator *alloc); + + int unbind (const EXT_ID &, + ACE_Allocator *alloc); + + int rebind (const EXT_ID &, + const INT_ID &, + EXT_ID &, + INT_ID &, + ACE_Allocator *alloc); + + int find (const EXT_ID &, + INT_ID &, + ACE_Allocator *alloc); + + /// Returns 0 if the @a ext_id is in the mapping, otherwise -1. + int find (const EXT_ID &ext_id, + ACE_Allocator *alloc); + + int close (ACE_Allocator *alloc); +}; + +ACE_END_VERSIONED_NAMESPACE_DECL + +#if defined (__ACE_INLINE__) +#include "ace/Hash_Map_With_Allocator_T.inl" +#endif /* __ACE_INLINE__ */ + +#if defined (ACE_TEMPLATES_REQUIRE_SOURCE) +#include "ace/Hash_Map_With_Allocator_T.cpp" +#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */ + +#if defined (ACE_TEMPLATES_REQUIRE_PRAGMA) +#pragma implementation ("Hash_Map_With_Allocator_T.cpp") +#endif /* ACE_TEMPLATES_REQUIRE_PRAGMA */ + + +#include /**/ "ace/post.h" +#endif /* ACE_HASH_MAP_WITH_ALLOCATOR_T_H */ |