1 | /*
|
---|
2 | * World.hpp
|
---|
3 | *
|
---|
4 | * Created on: Feb 3, 2010
|
---|
5 | * Author: crueger
|
---|
6 | */
|
---|
7 |
|
---|
8 | #ifndef WORLD_HPP_
|
---|
9 | #define WORLD_HPP_
|
---|
10 |
|
---|
11 | #include <string>
|
---|
12 | #include <map>
|
---|
13 | #include <vector>
|
---|
14 | #include <set>
|
---|
15 | #include <boost/thread.hpp>
|
---|
16 | #include <boost/shared_ptr.hpp>
|
---|
17 |
|
---|
18 | #include "defs.hpp"
|
---|
19 | #include "Patterns/Observer.hpp"
|
---|
20 | #include "Patterns/Cacheable.hpp"
|
---|
21 |
|
---|
22 | // forward declarations
|
---|
23 | class periodentafel;
|
---|
24 | class MoleculeListClass;
|
---|
25 | class atom;
|
---|
26 | class molecule;
|
---|
27 | class AtomDescriptor;
|
---|
28 | class AtomDescriptor_impl;
|
---|
29 | class MoleculeDescriptor;
|
---|
30 | class MoleculeDescriptor_impl;
|
---|
31 | class ManipulateAtomsProcess;
|
---|
32 | template<typename T>
|
---|
33 | class AtomsCalculation;
|
---|
34 |
|
---|
35 | class World : public Observable
|
---|
36 | {
|
---|
37 | // necessary for coupling with descriptors
|
---|
38 | friend class AtomDescriptor_impl;
|
---|
39 | friend class AtomDescriptor;
|
---|
40 | friend class MoleculeDescriptor_impl;
|
---|
41 | friend class MoleculeDescriptor;
|
---|
42 |
|
---|
43 | // Actions, calculations etc associated with the World
|
---|
44 | friend class ManipulateAtomsProcess;
|
---|
45 | template<typename> friend class AtomsCalculation;
|
---|
46 | public:
|
---|
47 | typedef std::map<atomId_t,atom*> AtomSet;
|
---|
48 | typedef std::map<moleculeId_t,molecule*> MoleculeSet;
|
---|
49 |
|
---|
50 | /***** getter and setter *****/
|
---|
51 | // reference to pointer is used for legacy reason... reference will be removed latter to keep encapsulation of World object
|
---|
52 | /**
|
---|
53 | * returns the periodentafel for the world.
|
---|
54 | */
|
---|
55 | periodentafel *&getPeriode();
|
---|
56 |
|
---|
57 | /**
|
---|
58 | * returns the first atom that matches a given descriptor.
|
---|
59 | * Do not rely on ordering for descriptors that match more than one atom.
|
---|
60 | */
|
---|
61 | atom* getAtom(AtomDescriptor descriptor);
|
---|
62 |
|
---|
63 | /**
|
---|
64 | * returns a vector containing all atoms that match a given descriptor
|
---|
65 | */
|
---|
66 | std::vector<atom*> getAllAtoms(AtomDescriptor descriptor);
|
---|
67 | std::vector<atom*> getAllAtoms();
|
---|
68 |
|
---|
69 | /**
|
---|
70 | * returns a calculation that calls a given function on all atoms matching a descriptor.
|
---|
71 | * the calculation is not called at this point and can be used as an action, i.e. be stored in
|
---|
72 | * menus, be kept around for later use etc.
|
---|
73 | */
|
---|
74 | template<typename T> AtomsCalculation<T>* calcOnAtoms(boost::function<T(atom*)>,std::string,AtomDescriptor);
|
---|
75 | template<typename T> AtomsCalculation<T>* calcOnAtoms(boost::function<T(atom*)>,std::string);
|
---|
76 |
|
---|
77 | /**
|
---|
78 | * get the number of atoms in the World
|
---|
79 | */
|
---|
80 | int numAtoms();
|
---|
81 |
|
---|
82 | /**
|
---|
83 | * returns the first molecule that matches a given descriptor.
|
---|
84 | * Do not rely on ordering for descriptors that match more than one molecule.
|
---|
85 | */
|
---|
86 | molecule *getMolecule(MoleculeDescriptor descriptor);
|
---|
87 |
|
---|
88 | /**
|
---|
89 | * returns a vector containing all molecules that match a given descriptor
|
---|
90 | */
|
---|
91 | std::vector<molecule*> getAllMolecules(MoleculeDescriptor descriptor);
|
---|
92 |
|
---|
93 | /**
|
---|
94 | * get the number of molecules in the World
|
---|
95 | */
|
---|
96 | int numMolecules();
|
---|
97 |
|
---|
98 | /***** Methods to work with the World *****/
|
---|
99 |
|
---|
100 | /**
|
---|
101 | * create a new molecule. This method should be used whenever any kind of molecule is needed. Assigns a unique
|
---|
102 | * ID to the molecule and stores it in the World for later retrieval. Do not create molecules directly.
|
---|
103 | */
|
---|
104 | molecule *createMolecule();
|
---|
105 |
|
---|
106 | void destroyMolecule(molecule*);
|
---|
107 | void destroyMolecule(moleculeId_t);
|
---|
108 |
|
---|
109 | /**
|
---|
110 | * Create a new atom. This method should be used whenever any atom is needed. Assigns a unique ID and stores
|
---|
111 | * the atom in the World. If the atom is not destroyed it will automatically be destroyed when the world ends.
|
---|
112 | */
|
---|
113 | atom *createAtom();
|
---|
114 |
|
---|
115 | /**
|
---|
116 | * Registers a Atom unknown to world. Needed in some rare cases, e.g. when cloning atoms, or in some unittests.
|
---|
117 | * Do not re-register Atoms already known to the world since this will cause double-frees.
|
---|
118 | */
|
---|
119 | int registerAtom(atom*);
|
---|
120 |
|
---|
121 | /**
|
---|
122 | * Delete some atom and erase it from the world. Use this whenever you need to destroy any atom. Do not call delete on
|
---|
123 | * atom directly since this will leave the pointer inside the world.
|
---|
124 | */
|
---|
125 | void destroyAtom(atom*);
|
---|
126 |
|
---|
127 | /**
|
---|
128 | * Delete some atom and erase it from the world. Use this whenever you need to destroy any atom. Do not call delete on
|
---|
129 | * atom directly since this will leave the pointer inside the world.
|
---|
130 | */
|
---|
131 | void destroyAtom(atomId_t);
|
---|
132 |
|
---|
133 | /**
|
---|
134 | * used when changing an atom Id.
|
---|
135 | * Unless you are calling this method from inside an atom don't fiddle with the third parameter.
|
---|
136 | *
|
---|
137 | * Return value indicates wether the change could be done or not.
|
---|
138 | */
|
---|
139 | bool changeAtomId(atomId_t oldId, atomId_t newId, atom* target=0);
|
---|
140 |
|
---|
141 | /**
|
---|
142 | * Produces a process that calls a function on all Atoms matching a given descriptor. The process is not
|
---|
143 | * called at this time, so it can be passed around, stored inside menuItems etc.
|
---|
144 | */
|
---|
145 | ManipulateAtomsProcess* manipulateAtoms(boost::function<void(atom*)>,std::string,AtomDescriptor);
|
---|
146 | ManipulateAtomsProcess* manipulateAtoms(boost::function<void(atom*)>,std::string);
|
---|
147 |
|
---|
148 | protected:
|
---|
149 | /**** Iterators to use internal data structures */
|
---|
150 |
|
---|
151 | // Atoms
|
---|
152 |
|
---|
153 | class AtomIterator {
|
---|
154 | public:
|
---|
155 | AtomIterator();
|
---|
156 | AtomIterator(AtomDescriptor, World*);
|
---|
157 | AtomIterator(const AtomIterator&);
|
---|
158 | AtomIterator& operator=(const AtomIterator&);
|
---|
159 | AtomIterator& operator++(); // prefix
|
---|
160 | AtomIterator operator++(int); // postfix with dummy parameter
|
---|
161 | bool operator==(const AtomIterator&);
|
---|
162 | bool operator==(const AtomSet::iterator&);
|
---|
163 | bool operator!=(const AtomIterator&);
|
---|
164 | bool operator!=(const AtomSet::iterator&);
|
---|
165 | atom* operator*();
|
---|
166 |
|
---|
167 | int getCount();
|
---|
168 | protected:
|
---|
169 | void advanceState();
|
---|
170 | AtomSet::iterator state;
|
---|
171 | boost::shared_ptr<AtomDescriptor_impl> descr;
|
---|
172 | int index;
|
---|
173 |
|
---|
174 | World* world;
|
---|
175 | };
|
---|
176 |
|
---|
177 | /**
|
---|
178 | * returns an iterator over all Atoms matching a given descriptor.
|
---|
179 | * used for internal purposes, like AtomProcesses and AtomCalculations.
|
---|
180 | */
|
---|
181 | AtomIterator getAtomIter(AtomDescriptor descr);
|
---|
182 |
|
---|
183 | /**
|
---|
184 | * returns an iterator to the end of the AtomSet. Due to overloading this iterator
|
---|
185 | * can be compared to iterators produced by getAtomIter (see the mis-matching types).
|
---|
186 | * Thus it can be used to detect when such an iterator is at the end of the list.
|
---|
187 | * used for internal purposes, like AtomProcesses and AtomCalculations.
|
---|
188 | */
|
---|
189 | AtomSet::iterator atomEnd();
|
---|
190 |
|
---|
191 | // Molecules
|
---|
192 |
|
---|
193 | class MoleculeIterator {
|
---|
194 | public:
|
---|
195 | MoleculeIterator();
|
---|
196 | MoleculeIterator(MoleculeDescriptor, World*);
|
---|
197 | MoleculeIterator(const MoleculeIterator&);
|
---|
198 | MoleculeIterator& operator=(const MoleculeIterator&);
|
---|
199 | MoleculeIterator& operator++(); // prefix
|
---|
200 | MoleculeIterator operator++(int); // postfix with dummy parameter
|
---|
201 | bool operator==(const MoleculeIterator&);
|
---|
202 | bool operator==(const MoleculeSet::iterator&);
|
---|
203 | bool operator!=(const MoleculeIterator&);
|
---|
204 | bool operator!=(const MoleculeSet::iterator&);
|
---|
205 | molecule* operator*();
|
---|
206 |
|
---|
207 | int getCount();
|
---|
208 | protected:
|
---|
209 | void advanceState();
|
---|
210 | MoleculeSet::iterator state;
|
---|
211 | boost::shared_ptr<MoleculeDescriptor_impl> descr;
|
---|
212 | int index;
|
---|
213 |
|
---|
214 | World* world;
|
---|
215 | };
|
---|
216 |
|
---|
217 | /**
|
---|
218 | * returns an iterator over all Molecules matching a given descriptor.
|
---|
219 | * used for internal purposes, like MoleculeProcesses and MoleculeCalculations.
|
---|
220 | */
|
---|
221 | MoleculeIterator getMoleculeIter(MoleculeDescriptor descr);
|
---|
222 |
|
---|
223 | /**
|
---|
224 | * returns an iterator to the end of the MoleculeSet. Due to overloading this iterator
|
---|
225 | * can be compared to iterators produced by getMoleculeIter (see the mis-matching types).
|
---|
226 | * Thus it can be used to detect when such an iterator is at the end of the list.
|
---|
227 | * used for internal purposes, like MoleculeProcesses and MoleculeCalculations.
|
---|
228 | */
|
---|
229 | MoleculeSet::iterator moleculeEnd();
|
---|
230 |
|
---|
231 |
|
---|
232 | /******* Internal manipulation routines for double callback and Observer mechanism ******/
|
---|
233 | void doManipulate(ManipulateAtomsProcess *);
|
---|
234 |
|
---|
235 | private:
|
---|
236 |
|
---|
237 | atomId_t getNextAtomId();
|
---|
238 | void releaseAtomId(atomId_t);
|
---|
239 | bool reserveAtomId(atomId_t);
|
---|
240 |
|
---|
241 | periodentafel *periode;
|
---|
242 | AtomSet atoms;
|
---|
243 | std::set<atomId_t> atomIdPool; //<!stores the pool for all available AtomIds below currAtomId
|
---|
244 | atomId_t currAtomId; //!< stores the next available Id for atoms
|
---|
245 | MoleculeSet molecules;
|
---|
246 | moleculeId_t currMoleculeId;
|
---|
247 |
|
---|
248 |
|
---|
249 | /***** singleton Stuff *****/
|
---|
250 | public:
|
---|
251 |
|
---|
252 | /**
|
---|
253 | * get the currently active instance of the World.
|
---|
254 | */
|
---|
255 | static World* get();
|
---|
256 |
|
---|
257 | /**
|
---|
258 | * destroy the currently active instance of the World.
|
---|
259 | */
|
---|
260 | static void destroy();
|
---|
261 |
|
---|
262 | /**
|
---|
263 | * destroy the currently active instance of the World and immidiately
|
---|
264 | * create a new one. Use this to reset while somebody is still Observing
|
---|
265 | * the world and should reset the observed instance. All observers will be
|
---|
266 | * sent the subjectKille() message from the old world.
|
---|
267 | */
|
---|
268 | static World* reset();
|
---|
269 |
|
---|
270 | private:
|
---|
271 | /**
|
---|
272 | * private constructor to ensure creation of the world using
|
---|
273 | * the singleton pattern.
|
---|
274 | */
|
---|
275 | World();
|
---|
276 |
|
---|
277 | /**
|
---|
278 | * private destructor to ensure destruction of the world using the
|
---|
279 | * singleton pattern.
|
---|
280 | */
|
---|
281 | virtual ~World();
|
---|
282 |
|
---|
283 | static World *theWorld;
|
---|
284 | // this mutex only saves the singleton pattern...
|
---|
285 | // use other mutexes to protect internal data as well
|
---|
286 | // this mutex handles access to the pointer, not to the object!!!
|
---|
287 | static boost::mutex worldLock;
|
---|
288 |
|
---|
289 | /*****
|
---|
290 | * some legacy stuff that is include for now but will be removed later
|
---|
291 | *****/
|
---|
292 | public:
|
---|
293 | MoleculeListClass *&getMolecules();
|
---|
294 |
|
---|
295 | private:
|
---|
296 | MoleculeListClass *molecules_deprecated;
|
---|
297 | };
|
---|
298 |
|
---|
299 | #endif /* WORLD_HPP_ */
|
---|