Changeset 567640 for src/Patterns/PrototypeFactory.hpp

Timestamp:

Jan 6, 2011, 12:22:12 PM (15 years ago)

Author:

Frederik Heber <heber@…>

Children:

9f39db

Parents:

d76c105

Message:

PrototypeFactory now allows for replacing prototypes.

• if a prototype can only be manipulated via its constructor, it is essential for the factory to allow for changing prototypes in a controlled manner. All the functions on prototypes are protected, hence only friends may get access.
• Library version is now 3:1:1, API version is 1.0.6.

File:

• src/Patterns/PrototypeFactory.hpp (modified) (4 diffs)

src/Patterns/PrototypeFactory.hpp

@@ -364 +364 @@
 
 protected:
-  /** Getter for the true prototype of the product.
+  /** Yields true prototype of the product and sets entry to NULL on
+   *  PrototypeTable.
   *
   * @warning This method is \b intentionally protected such that only
@@ -378 +379 @@
   {
     ASSERT(enums.count(instance_name) != 0,
-        "PrototypeFactory<"+toString(typeid(T).name())+">::getProduct() - type name "+instance_name+" is not registered.");
-    return dynamic_cast<T *>(PrototypeTable[ enums[instance_name] ]);
-  }
-
-  /** Getter for the true prototype of the product.
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - type name "+instance_name+" is not registered.");
+    T* prototype = dynamic_cast<T *>(PrototypeTable[ enums[instance_name] ]);
+    return prototype;
+  }
+
+  /** Yields true prototype of the product and sets entry to NULL on
+   *  PrototypeTable.
   *
   * @warning This method is \b intentionally protected such that only
@@ -393 +396 @@
   {
     ASSERT(names.count(instance_type) != 0,
-        "PrototypeFactory<"+toString(typeid(T).name())+">::getProduct() - enum type "+toString(instance_type)+" is not registered.");
-    return dynamic_cast<T *>(PrototypeTable[instance_type]);
-  }
-
-  /** Getter for the true prototype of the product.
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - enum type "+toString(instance_type)+" is not registered.");
+    T* prototype = dynamic_cast<T *>(PrototypeTable[instance_type]);
+    return prototype;
+  }
+
+  /** Yields true prototype of the product and sets entry to NULL on
+   *  PrototypeTable.
   *
   * @warning This method is \b intentionally protected such that only
@@ -408 +413 @@
   {
     ASSERT(types.count(instance_type_info.name()) != 0,
-        "PrototypeFactory<"+toString(typeid(T).name())+">::getProduct() - type info name "+instance_type_info.name()+" is not registered.");
-    return dynamic_cast<T *>(PrototypeTable[ types[instance_type_info.name()] ]);
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - type info name "+instance_type_info.name()+" is not registered.");
+    T* prototype = dynamic_cast<T *>(PrototypeTable[ types[instance_type_info.name()] ]);
+    return prototype;
+  }
+
+  /** Yields true prototype of the currenttype product and sets entry to NULL
+   *  on PrototypeTable.
+  *
+  * @warning This method is \b intentionally protected such that only
+  * specific friends are allowed to access it.
+  *
+  * @return reference to prototype stored in this factory
+  */
+  T* getPrototypeManipulator()
+  {
+    T* prototype = dynamic_cast<T *>(PrototypeTable[ currenttype ]);
+    return prototype;
+  }
+
+  /** Allows returning (a possibly different) prototype which is stored in
+   *  PrototypeTable.
+   *
+   * @warning a prototype has to be delivered by getPrototypeManipulator()
+   * before it can be returned again.
+   *
+   * @param _newprototype reference to new prototype
+   * @param instance_name name of particular type
+   */
+  void installPrototype(Clone<T> *_newprototype, const std::string instance_name)
+  {
+    ASSERT(enums.count(instance_name) != 0,
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - type name "+instance_name+" is not registered.");
+    ASSERT(typeid(PrototypeTable[ enums[instance_name] ]) == typeid(_newprototype),
+        "PrototypeFactory<"+toString(typeid(T).name())+">::installPrototype() - new prototype is not of the necessary type "+instance_name+".");
+    // TODO: use boost::shared_ptr to store prototypes instead!
+    delete PrototypeTable[ enums[instance_name] ];
+    PrototypeTable[ enums[instance_name] ] = _newprototype;
+  }
+
+  /** Allows returning (a possibly different) prototype which is stored in
+   *  PrototypeTable.
+   *
+   * @warning a prototype has to be delivered by getPrototypeManipulator()
+   * before it can be returned again.
+   *
+   * @param _newprototype reference to new prototype
+   * @param instance_type enumeration index of particular type
+   */
+  void installPrototype(Clone<T> *_newprototype, TypeList instance_type)
+  {
+    ASSERT(names.count(instance_type) != 0,
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - enum type "+toString(instance_type)+" is not registered.");
+    ASSERT( typeid(PrototypeTable[ instance_type ]) == typeid(_newprototype),
+        "PrototypeFactory<"+toString(typeid(T).name())+">::installPrototype() - new prototype is not of the necessary type "+names[instance_type]+".");
+    // TODO: use boost::shared_ptr to store prototypes instead!
+    delete PrototypeTable[ instance_type ];
+    PrototypeTable[ instance_type ] = _newprototype;
+  }
+
+  /** Allows returning (a possibly different) prototype which is stored in
+   *  PrototypeTable.
+   *
+   * @warning a prototype has to be delivered by getPrototypeManipulator()
+   * before it can be returned again.
+   *
+   * @param _newprototype reference to new prototype
+   * @param instance_type_info type_info of particular type
+   */
+  void installPrototype(Clone<T> *_newprototype, const std::type_info &instance_type_info)
+  {
+    ASSERT(types.count(instance_type_info.name()) != 0,
+        "PrototypeFactory<"+toString(typeid(T).name())+">::getPrototypeManipulator() - type info name "+instance_type_info.name()+" is not registered.");
+    ASSERT( typeid(PrototypeTable[ types[instance_type_info.name()] ]) == typeid(_newprototype),
+        "PrototypeFactory<"+toString(typeid(T).name())+">::installPrototype() - new prototype is not of the necessary type "+instance_type_info.name()+".");
+    // TODO: use boost::shared_ptr to store prototypes instead!
+    PrototypeTable[ types[instance_type_info.name()] ] = _newprototype;
+  }
+
+  /** Allows returning (a possibly different) prototype which is stored in
+   *  PrototypeTable.
+   *
+   * @warning a prototype has to be delivered by getPrototypeManipulator()
+   * before it can be returned again.
+   *
+   * @param _newprototype reference to new prototype
+   * @param instance_type_info type_info of particular type
+   */
+  void installPrototype(Clone<T> *_newprototype)
+  {
+    ASSERT( typeid(PrototypeTable[ currenttype ]) == typeid(_newprototype),
+        "PrototypeFactory<"+toString(typeid(T).name())+">::installPrototype() - new prototype is not of the necessary type "+names[currenttype]+".");
+    // TODO: use boost::shared_ptr to store prototypes instead!
+    PrototypeTable[ currenttype ] = _newprototype;
   }