extreme refactoring

[chaz/yoink] / src / Moof / Mippleton.hh

diff --git a/src/Moof/Mippleton.hh b/src/Moof/Mippleton.hh
new file mode 100644 (file)
index 0000000..95d3f21
--- /dev/null
+++ b/src/Moof/Mippleton.hh
@@ -0,0 +1,109 @@
+
+/*******************************************************************************
+
+ Copyright (c) 2009, Charles McGarvey
+ All rights reserved.
+ 
+ Redistribution   and   use  in  source  and  binary  forms,  with  or  without
+ modification, are permitted provided that the following conditions are met:
+ 
+   * Redistributions  of  source  code  must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+   * Redistributions  in binary form must reproduce the above copyright notice,
+     this  list of conditions and the following disclaimer in the documentation
+     and/or other materials provided with the distribution.
+ 
+ THIS  SOFTWARE  IS  PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ AND  ANY  EXPRESS  OR  IMPLIED  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED.  IN  NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ FOR  ANY  DIRECT,  INDIRECT,  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES  (INCLUDING,  BUT  NOT  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES;  LOSS  OF  USE,  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED  AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+*******************************************************************************/
+
+#ifndef _MOOF_MIPPLETON_HH_
+#define _MOOF_MIPPLETON_HH_
+
+/**
+ * @file Mippleton.hh
+ * Related to singletons, a mippleton is an object which can be obtained
+ * globally using a unique name.  Unlike singletons, there can be multiple
+ * mippletons per class, each with a different name or identifier.  Mippletons
+ * are create automatically when they are first requested (retained) and deleted
+ * after the last interested code releases its hold on the object.
+ */
+
+#include <map>
+#include <string>
+
+
+namespace Mf {
+
+
+template <class T>
+class Mippleton
+{
+       typedef std::pair<unsigned,T*>                          ptr_value_t;
+       typedef std::pair<std::string,ptr_value_t>      ptr_map_pair_t;
+       typedef std::map<std::string,ptr_value_t>       ptr_map_t;
+
+       static ptr_map_t ptrs_;
+       std::string name_;
+
+public:
+       explicit Mippleton(const std::string& name) : name_(name) {}
+
+       inline const std::string& getName() const
+       {
+               return name_;
+       }
+
+       inline static T* retain(const std::string& name)
+       {
+               typename ptr_map_t::iterator it;
+
+               if ((it = ptrs_.find(name)) != ptrs_.end())
+               {
+                       (*it).second.first++;
+                       return (*it).second.second;
+               }
+               else
+               {
+                       T* newObj = new T(name);
+                       ptrs_.insert(ptr_map_pair_t(name, ptr_value_t(1, newObj)));
+                       return newObj; 
+               }
+       }
+
+       inline static void releaseByName(const std::string& name)
+       {
+               typename ptr_map_t::iterator it;
+
+               if ((it = ptrs_.find(name)) != ptrs_.end() && -(*it).second.first == 0)
+               {
+                       delete (*it).second.second;
+                       ptrs_.erase(it);
+               }
+       }
+
+       inline static void release(T* obj)
+       {
+               releaseByName(obj->getName());
+       }
+};
+
+template <class T>
+std::map<std::string,std::pair<unsigned,T*> > Mippleton<T>::ptrs_;
+
+
+} // namespace Mf
+
+#endif // _MOOF_MIPPLETON_HH_
+
+/** vim: set ts=4 sw=4 tw=80: *************************************************/
+