ACE_Static_Object_Lock Class Reference

Provide an interface to access a global lock. More...

#include <Static_Object_Lock.h>

List of all members.

Static Public Member Functions
ACE_Recursive_Thread_Mutex *	instance (void)
	Static lock access point.
void	cleanup_lock (void)

---

Detailed Description

Provide an interface to access a global lock.

This class is used to serialize the creation of static singleton objects. It really isn't needed any more, because anyone can access ACE_STATIC_OBJECT_LOCK directly. But, it is retained for backward compatibility.

Definition at line 41 of file Static_Object_Lock.h.

---

Member Function Documentation

void ACE_Static_Object_Lock::cleanup_lock (  void   )  [static]

For use only by ACE_Object_Manager to clean up lock if it what dynamically allocated. Definition at line 839 of file Object_Manager.cpp. References ACE_DES_FREE, ACE_Static_Object_Lock_lock, and ACE_Static_Object_Lock_Type. Referenced by ACE_Object_Manager::fini(). { # if defined(ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK) // It was malloc'd, so we need to explicitly call the dtor // and then free the memory. ACE_DES_FREE (ACE_Static_Object_Lock_lock, ACE_OS::free, ACE_Static_Object_Lock_Type); # else /* ! ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK */ delete ACE_Static_Object_Lock_lock; # endif /* ! ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK */ ACE_Static_Object_Lock_lock = 0; }

ACE_Recursive_Thread_Mutex * ACE_Static_Object_Lock::instance (  void   )  [static]

Static lock access point. Definition at line 793 of file Object_Manager.cpp. References ACE_NEW_RETURN, ACE_Static_Object_Lock_lock, ACE_Static_Object_Lock_Type, ACE_OS::malloc(), ACE_Cleanup_Adapter< TYPE >::object(), ACE_Object_Manager::shutting_down(), and ACE_Object_Manager::starting_up(). { if (ACE_Object_Manager::starting_up () || ACE_Object_Manager::shutting_down ()) { // The preallocated ACE_STATIC_OBJECT_LOCK has not been // constructed yet. Therefore, the program is single-threaded // at this point. Or, the ACE_Object_Manager instance has been // destroyed, so the preallocated lock is not available. // Allocate a lock to use, for interface compatibility, though // there should be no contention on it. if (ACE_Static_Object_Lock_lock == 0) { # if defined (ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK) // Allocate a buffer with malloc, and then use placement // new for the object, on the malloc'd buffer. void *buffer = ACE_OS::malloc (sizeof (*ACE_Static_Object_Lock_lock)); if (buffer == 0) { return 0; } ACE_NEW_RETURN (ACE_Static_Object_Lock_lock, (buffer) ACE_Static_Object_Lock_Type (), 0); # else /* ! ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK */ ACE_NEW_RETURN (ACE_Static_Object_Lock_lock, ACE_Cleanup_Adapter<ACE_Recursive_Thread_Mutex>, 0); # endif /* ! ACE_SHOULD_MALLOC_STATIC_OBJECT_LOCK */ } // Can't register with the ACE_Object_Manager here! The lock's // declaration is visible to the ACE_Object_Manager destructor, // so it will clean it up as a special case. return &ACE_Static_Object_Lock_lock->object (); } else // Return the preallocated ACE_STATIC_OBJECT_LOCK. return ACE_Managed_Object<ACE_Recursive_Thread_Mutex>::get_preallocated_object (ACE_Object_Manager::ACE_STATIC_OBJECT_LOCK); }

---

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

• Static_Object_Lock.h
• Object_Manager.cpp

---