summaryrefslogtreecommitdiff
path: root/ace/Managed_Object.h
diff options
context:
space:
mode:
Diffstat (limited to 'ace/Managed_Object.h')
-rw-r--r--ace/Managed_Object.h153
1 files changed, 0 insertions, 153 deletions
diff --git a/ace/Managed_Object.h b/ace/Managed_Object.h
deleted file mode 100644
index 0566718159f..00000000000
--- a/ace/Managed_Object.h
+++ /dev/null
@@ -1,153 +0,0 @@
-/* -*- C++ -*- */
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-// ace
-//
-// = FILENAME
-// Managed_Object.h
-//
-// = AUTHORS
-// David L. Levine
-//
-// ============================================================================
-
-#if !defined (ACE_MANAGED_OBJECT_H)
-#define ACE_MANAGED_OBJECT_H
-
-#include "ace/OS.h"
-#include "ace/Object_Manager.h"
-
-template <class TYPE>
-class ACE_Cleanup_Adapter : public ACE_Cleanup
-{
- // = TITLE
- // Adapter for ACE_Cleanup objects that allows them to be readily
- // managed by the ACE_Object_Manager.
- //
- // = DESCRIPTION
- // This template class adapts an object of any type to be an
- // ACE_Cleanup object. The object can then be destroyed
- // type-safely by the ACE_Object_Manager. This class is
- // typically used to replace a cast; but, it's a bit cleaner and
- // allows insertion of, say, run-time type identification
- // internally if desired.
-public:
- ACE_Cleanup_Adapter (void);
- // Default constructor.
-
- virtual ~ACE_Cleanup_Adapter (void);
- // Virtual destructor, needed by some compilers for vtable placement.
-
- TYPE &object (void);
- // Accessor for contained object.
-
-private:
- TYPE object_;
- // Contained object.
-};
-
-template <class TYPE>
-class ACE_Managed_Object
-{
- // = TITLE
- // Wrapper for interface to allocate an object managed by the
- // ACE_Object_Manager.
- //
- // = DESCRIPTION
- // This template class wraps an interface that is used to
- // allocate and access an object that is managed by the
- // ACE_Object_Manager. Because static template member functions
- // are not supported by most compilers, it is a separate
- // (template) class.
- //
- // This interface is typically used to replace a static object
- // with one that is dynamically allocated. It helps to avoid
- // problems with order of static object
- // construction/destruction. Managed objects won't be allocated
- // until needed, but should be allocated when first needed. And
- // they are destroyed in the reverse order of construction.
- //
- // get_preallocated_object () accesses a "preallocated" object,
- // i.e., one that is identified by a value in the
- // ACE_Object_Manager:: Preallocated_Object enum. These objects
- // are used internally by the ACE library.
- //
- // Hooks are provided for the application to preallocate objects
- // via the same mechanism.
- // ACE_APPLICATION_PREALLOCATED_OBJECT_DECLARATIONS can be used
- // to define enum values;
- // ACE_APPLICATION_PREALLOCATED_OBJECT_DEFINITIONS can be used
- // to define the corresponding objects. The format of the ACE
- // internal library definitions should be followed. And
- // similarly, ACE_APPLICATION_PREALLOCATED_ARRAY_DECLARATIONS
- // and ACE_APPLICATION_PREALLOCATED_ARRAY_DEFINITIONS can be
- // used to preallocate arrays.
- //
- // By default, preallocation uses dynamic allocation. The
- // preallocated objects and arrays are allocated off the heap in
- // the ACE_Object_Manager constructor. The statically place the
- // preallocated objects in program global data instead of on the
- // heap, #define ACE_HAS_STATIC_PREALLOCATION prior to building
- // the ACE library.
-public:
- static TYPE *get_preallocated_object (ACE_Object_Manager::Preallocated_Object id)
- {
- // The preallocated objects are in a separate, "read-only" array so
- // that this function doesn't need a lock. Also, because it is
- // intended _only_ for use with hard-code values, it performs no
- // range checking on "id".
-
- // Cast the return type of the the object pointer based
- // on the type of the function template parameter.
- return &((ACE_Cleanup_Adapter<TYPE> *)
- ACE_Object_Manager::preallocated_object[id])->object ();
- }
- // Get the preallocated object identified by "id". Returns a
- // pointer to the object. Beware: no error indication is provided,
- // because it can _only_ be used for accessing preallocated objects.
- // Note: the function definition is inlined here so that it compiles
- // on AIX 4.1 w/xlC v. 3.01.
-
- static TYPE *get_preallocated_array (ACE_Object_Manager::Preallocated_Array id)
- {
- // The preallocated array are in a separate, "read-only" array so
- // that this function doesn't need a lock. Also, because it is
- // intended _only_ for use with hard-code values, it performs no
- // range checking on "id".
-
- // Cast the return type of the the object pointer based
- // on the type of the function template parameter.
- return &((ACE_Cleanup_Adapter<TYPE> *)
- ACE_Object_Manager::preallocated_array[id])->object ();
- }
- // Get the preallocated array identified by "id". Returns a
- // pointer to the array. Beware: no error indication is provided,
- // because it can _only_ be used for accessing preallocated arrays.
- // Note: the function definition is inlined here so that it compiles
- // on AIX 4.1 w/xlC v. 3.01.
-
-private:
- // Disallow instantiation of this class.
- ACE_UNIMPLEMENTED_FUNC (ACE_Managed_Object ())
- ACE_UNIMPLEMENTED_FUNC (ACE_Managed_Object (const ACE_Managed_Object<TYPE> &))
- ACE_UNIMPLEMENTED_FUNC (void operator= (const ACE_Managed_Object<TYPE> &))
-
- friend class this_prevents_compiler_warning_about_only_private_constructors;
-};
-
-#if defined (__ACE_INLINE__)
-#include "ace/Managed_Object.i"
-#endif /* __ACE_INLINE__ */
-
-#if defined (ACE_TEMPLATES_REQUIRE_SOURCE)
-#include "ace/Managed_Object.cpp"
-#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */
-
-#if defined (ACE_TEMPLATES_REQUIRE_PRAGMA)
-#pragma implementation ("Managed_Object.cpp")
-#endif /* ACE_TEMPLATES_REQUIRE_PRAGMA */
-
-#endif /* ACE_MANAGED_OBJECT_H */