1 |
chuckv |
522 |
/* |
2 |
|
|
* GeometryFactory.hpp |
3 |
|
|
* OOPSE-2.0 |
4 |
|
|
* |
5 |
|
|
* Created by Charles F. Vardeman II on 5/3/05. |
6 |
|
|
* Copyright (c) 2005 The University of Notre Dame. All Rights Reserved. |
7 |
|
|
* |
8 |
|
|
* The University of Notre Dame grants you ("Licensee") a |
9 |
|
|
* non-exclusive, royalty free, license to use, modify and |
10 |
|
|
* redistribute this software in source and binary code form, provided |
11 |
|
|
* that the following conditions are met: |
12 |
|
|
* |
13 |
|
|
* 1. Acknowledgement of the program authors must be made in any |
14 |
|
|
* publication of scientific results based in part on use of the |
15 |
|
|
* program. An acceptable form of acknowledgement is citation of |
16 |
|
|
* the article in which the program was described (Matthew |
17 |
|
|
* A. Meineke, Charles F. Vardeman II, Teng Lin, Christopher |
18 |
|
|
* J. Fennell and J. Daniel Gezelter, "OOPSE: An Object-Oriented |
19 |
|
|
* Parallel Simulation Engine for Molecular Dynamics," |
20 |
|
|
* J. Comput. Chem. 26, pp. 252-271 (2005)) |
21 |
|
|
* |
22 |
|
|
* 2. Redistributions of source code must retain the above copyright |
23 |
|
|
* notice, this list of conditions and the following disclaimer. |
24 |
|
|
* |
25 |
|
|
* 3. Redistributions in binary form must reproduce the above copyright |
26 |
|
|
* notice, this list of conditions and the following disclaimer in the |
27 |
|
|
* documentation and/or other materials provided with the |
28 |
|
|
* distribution. |
29 |
|
|
* |
30 |
|
|
* This software is provided "AS IS," without a warranty of any |
31 |
|
|
* kind. All express or implied conditions, representations and |
32 |
|
|
* warranties, including any implied warranty of merchantability, |
33 |
|
|
* fitness for a particular purpose or non-infringement, are hereby |
34 |
|
|
* excluded. The University of Notre Dame and its licensors shall not |
35 |
|
|
* be liable for any damages suffered by licensee as a result of |
36 |
|
|
* using, modifying or distributing the software or its |
37 |
|
|
* derivatives. In no event will the University of Notre Dame or its |
38 |
|
|
* licensors be liable for any lost revenue, profit or data, or for |
39 |
|
|
* direct, indirect, special, consequential, incidental or punitive |
40 |
|
|
* damages, however caused and regardless of the theory of liability, |
41 |
|
|
* arising out of the use of or inability to use software, even if the |
42 |
|
|
* University of Notre Dame has been advised of the possibility of |
43 |
|
|
* such damages. |
44 |
|
|
*/ |
45 |
|
|
#ifndef NANORODBUILDER_GEOMETRYFACTORY_HPP |
46 |
|
|
#define NANORODBUILDER_GEOMETRYFACTORY_HPP |
47 |
|
|
#include <cassert> |
48 |
|
|
#include <map> |
49 |
|
|
#include <string> |
50 |
|
|
#include <vector> |
51 |
|
|
#include <iostream> |
52 |
|
|
namespace oopse { |
53 |
|
|
|
54 |
|
|
//forward declaration |
55 |
|
|
class Geometry; |
56 |
|
|
class GeometryCreator; |
57 |
|
|
/** |
58 |
|
|
* @class GeometryFactory GeometryFactory.hpp |
59 |
|
|
* Factory pattern and Singleton Pattern are used to define an interface for creating an Lattice. |
60 |
|
|
*/ |
61 |
|
|
class GeometryFactory { |
62 |
|
|
public: |
63 |
|
|
|
64 |
chuckv |
542 |
typedef std::map<std::string, GeometryCreator*> CreatorMapType; |
65 |
chuckv |
522 |
typedef std::vector<std::string> IdentVectorType; |
66 |
|
|
typedef std::vector<std::string>::iterator IdentVectorIterator; |
67 |
|
|
|
68 |
|
|
~GeometryFactory(); |
69 |
|
|
|
70 |
|
|
/** |
71 |
|
|
* Returns an instance of Geometry factory |
72 |
|
|
* @return an instance of Geometry factory |
73 |
|
|
*/ |
74 |
|
|
static GeometryFactory* getInstance() { |
75 |
|
|
|
76 |
|
|
if (instance_ == NULL) { |
77 |
|
|
instance_ = new GeometryFactory(); |
78 |
|
|
} |
79 |
|
|
return instance_; |
80 |
|
|
|
81 |
|
|
} |
82 |
|
|
|
83 |
|
|
/** |
84 |
|
|
* Registers a creator with a type identifier |
85 |
|
|
* @return true if registration is succeed, otherwise return false |
86 |
|
|
* @id the identification of the concrete object |
87 |
|
|
* @creator the object responsible to create the concrete object |
88 |
|
|
*/ |
89 |
|
|
bool registerGeometry(GeometryCreator* creator); |
90 |
|
|
|
91 |
|
|
/** |
92 |
|
|
* Unregisters the creator for the given type identifier. If the type identifier |
93 |
|
|
* was previously registered, the function returns true. |
94 |
|
|
* @return truethe type identifier was previously registered and the creator is removed, |
95 |
|
|
* otherwise return false |
96 |
|
|
* @id the identification of the concrete object |
97 |
|
|
*/ |
98 |
|
|
bool unregisterGeometry(const std::string& id); |
99 |
|
|
/** |
100 |
|
|
* Looks up the type identifier in the internal map. If it is found, it invokes the |
101 |
|
|
* corresponding creator for the type identifier and returns its result. |
102 |
|
|
* @return a pointer of the concrete object, return NULL if no creator is registed for |
103 |
|
|
* creating this concrete object |
104 |
|
|
* @param id the identification of the concrete object |
105 |
|
|
*/ |
106 |
chuckv |
542 |
Geometry* createGeometry(const std::string& id); |
107 |
chuckv |
522 |
|
108 |
|
|
/** |
109 |
|
|
* Returns all of the registed type identifiers |
110 |
|
|
* @return all of the registed type identifiers |
111 |
|
|
*/ |
112 |
|
|
IdentVectorType getIdents(); |
113 |
|
|
|
114 |
|
|
private: |
115 |
|
|
GeometryFactory() {} |
116 |
|
|
|
117 |
|
|
static GeometryFactory* instance_; |
118 |
|
|
CreatorMapType creatorMap_; |
119 |
|
|
}; |
120 |
|
|
|
121 |
|
|
/** write out all of the type identifiers to an output stream */ |
122 |
|
|
std::ostream& operator <<(std::ostream& o, GeometryFactory& factory); |
123 |
|
|
|
124 |
|
|
}//namespace oopse |
125 |
|
|
#endif //NANORODBUILDER_GEOMETRYFACTORY_HPP |