Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/core/ConfigFileManager.h @ 1784

Last change on this file since 1784 was 1784, checked in by rgrieder, 16 years ago
  • removed obsolete Convert.h includes (possibly from old XML loading)
  • replaced tabs in audio library, plus minor code cleanup because removing the tabs screwed layout
  • replaced all "#define name number" with "const Type name = number" if possible
  • Property svn:eol-style set to native
File size: 12.5 KB
Line 
1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Fabian 'x3n' Landau
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29#ifndef _ConfigFileManager_H__
30#define _ConfigFileManager_H__
31
32#include "CorePrereqs.h"
33
34#include <iostream>
35#include <string>
36#include <list>
37#include <map>
38
39#include "util/Math.h"
40
41namespace orxonox
42{
43    enum _CoreExport ConfigFileType
44    {
45        CFT_Settings,
46        CFT_Keybindings
47    };
48
49
50    bool config(const std::string& classname, const std::string& varname, const std::string& value);
51    bool tconfig(const std::string& classname, const std::string& varname, const std::string& value);
52    void reloadConfig();
53    void saveConfig();
54    void cleanConfig();
55    void loadSettings(const std::string& filename);
56    void loadKeybindings(const std::string& filename);
57
58
59    /////////////////////
60    // ConfigFileEntry //
61    /////////////////////
62    class _CoreExport ConfigFileEntry
63    {
64        public:
65            virtual ~ConfigFileEntry() {};
66            virtual void setValue(const std::string& value) = 0;
67            virtual std::string getValue() const = 0;
68            virtual const std::string& getName() const = 0;
69            virtual void setComment(const std::string& comment) = 0;
70            virtual unsigned int getIndex() const { return 0; }
71            virtual void setString(bool bString) = 0;
72            virtual std::string getFileEntry() const = 0;
73    };
74
75
76    //////////////////////////
77    // ConfigFileEntryValue //
78    //////////////////////////
79    class _CoreExport ConfigFileEntryValue : public ConfigFileEntry
80    {
81        public:
82            inline ConfigFileEntryValue(const std::string& name, const std::string& value = "", bool bString = false, const std::string& additionalComment = "") : name_(name), value_(value), bString_(bString), additionalComment_(additionalComment) {}
83            inline virtual ~ConfigFileEntryValue() {}
84
85            inline virtual const std::string& getName() const
86                { return this->name_; }
87
88            inline virtual void setComment(const std::string& comment)
89                { this->additionalComment_ = comment; }
90
91            virtual void setValue(const std::string& value);
92            virtual std::string getValue() const;
93
94            inline bool isString() const
95                { return this->bString_; }
96            inline void setString(bool bString)
97                { this->bString_ = bString; }
98
99            virtual std::string getFileEntry() const;
100
101        protected:
102            std::string name_;
103            std::string value_;
104            bool bString_;
105            std::string additionalComment_;
106    };
107
108
109    ///////////////////////////////
110    // ConfigFileEntryVectorValue //
111    ///////////////////////////////
112    class _CoreExport ConfigFileEntryVectorValue : public ConfigFileEntryValue
113    {
114        public:
115            inline ConfigFileEntryVectorValue(const std::string& name, unsigned int index, const std::string& value = "", bool bString = false, const std::string& additionalComment = "") : ConfigFileEntryValue(name, value, bString, additionalComment), index_(index) {}
116            inline virtual ~ConfigFileEntryVectorValue() {}
117
118            inline virtual unsigned int getIndex() const
119                { return this->index_; }
120
121            virtual std::string getFileEntry() const;
122
123        private:
124            unsigned int index_;
125    };
126
127
128    ////////////////////////////
129    // ConfigFileEntryComment //
130    ////////////////////////////
131    class _CoreExport ConfigFileEntryComment : public ConfigFileEntry
132    {
133        public:
134            inline ConfigFileEntryComment(const std::string& comment) : comment_(comment) {}
135            inline virtual ~ConfigFileEntryComment() {}
136
137            inline virtual const std::string& getName() const
138                { return this->comment_; }
139
140            inline virtual void setComment(const std::string& comment)
141                { this->comment_ = comment; }
142
143            inline virtual void setValue(const std::string& value)
144                {}
145            inline virtual std::string getValue() const
146                { return this->comment_; }
147
148            inline void setString(bool bString) {}
149
150            inline virtual std::string getFileEntry() const
151                { return this->comment_; }
152
153        private:
154            std::string comment_;
155    };
156
157
158    ///////////////////////
159    // ConfigFileSection //
160    ///////////////////////
161    class _CoreExport ConfigFileSection
162    {
163        friend class ConfigFile;
164
165        public:
166            inline ConfigFileSection(const std::string& name, const std::string& additionalComment = "") : name_(name), additionalComment_(additionalComment), bUpdated_(false) {}
167            ~ConfigFileSection();
168
169            inline const std::string& getName() const
170                { return this->name_; }
171
172            inline void setComment(const std::string& comment)
173                { this->additionalComment_ = comment; }
174
175            inline void setValue(const std::string& name, const std::string& value, bool bString)
176                { this->getEntry(name, value, bString)->setValue(value); }
177            inline std::string getValue(const std::string& name, const std::string& fallback, bool bString)
178                { return this->getEntry(name, fallback, bString)->getValue(); }
179
180            inline void setValue(const std::string& name, unsigned int index, const std::string& value, bool bString)
181                { this->getEntry(name, index, value, bString)->setValue(value); }
182            inline std::string getValue(const std::string& name, unsigned int index, const std::string& fallback, bool bString)
183                { return this->getEntry(name, index, fallback, bString)->getValue(); }
184
185            void deleteVectorEntries(const std::string& name, unsigned int startindex = 0);
186            unsigned int getVectorSize(const std::string& name);
187
188            std::string getFileEntry() const;
189
190        private:
191            std::list<ConfigFileEntry*>& getEntries()
192                { return this->entries_; }
193            std::list<ConfigFileEntry*>::const_iterator getEntriesBegin() const
194                { return this->entries_.begin(); }
195            std::list<ConfigFileEntry*>::const_iterator getEntriesEnd() const
196                { return this->entries_.end(); }
197
198            std::list<ConfigFileEntry*>::iterator getEntryIterator(const std::string& name, const std::string& fallback, bool bString);
199            std::list<ConfigFileEntry*>::iterator getEntryIterator(const std::string& name, unsigned int index, const std::string& fallback, bool bString);
200
201            inline ConfigFileEntry* getEntry(const std::string& name, const std::string& fallback, bool bString)
202                { return (*this->getEntryIterator(name, fallback, bString)); }
203            inline ConfigFileEntry* getEntry(const std::string& name, unsigned int index, const std::string& fallback, bool bString)
204                { return (*this->getEntryIterator(name, index, fallback, bString)); }
205
206            std::string name_;
207            std::string additionalComment_;
208            std::list<ConfigFileEntry*> entries_;
209            bool bUpdated_;
210    };
211
212
213    ////////////////
214    // ConfigFile //
215    ////////////////
216    class _CoreExport ConfigFile
217    {
218        public:
219            inline ConfigFile(const std::string& filename) : filename_(filename), bUpdated_(false) {}
220            ~ConfigFile();
221
222            void load(bool bCreateIfNotExisting = true);
223            void save() const;
224            void save(const std::string& filename);
225            void clean(bool bCleanComments = false);
226
227            inline void setValue(const std::string& section, const std::string& name, const std::string& value, bool bString)
228                { this->getSection(section)->setValue(name, value, bString); this->save(); }
229            inline std::string getValue(const std::string& section, const std::string& name, const std::string& fallback, bool bString)
230                { std::string output = this->getSection(section)->getValue(name, fallback, bString); this->saveIfUpdated(); return output; }
231
232            inline void setValue(const std::string& section, const std::string& name, unsigned int index, const std::string& value, bool bString)
233                { this->getSection(section)->setValue(name, index, value, bString); this->save(); }
234            inline std::string getValue(const std::string& section, const std::string& name, unsigned int index, const std::string& fallback, bool bString)
235                { std::string output = this->getSection(section)->getValue(name, index, fallback, bString); this->saveIfUpdated(); return output; }
236
237            inline void deleteVectorEntries(const std::string& section, const std::string& name, unsigned int startindex = 0)
238                { this->getSection(section)->deleteVectorEntries(name, startindex); }
239            inline unsigned int getVectorSize(const std::string& section, const std::string& name)
240                { return this->getSection(section)->getVectorSize(name); }
241
242        private:
243            ConfigFileSection* getSection(const std::string& section);
244            void saveIfUpdated();
245
246            std::string filename_;
247            std::list<ConfigFileSection*> sections_;
248            bool bUpdated_;
249    };
250
251
252    ///////////////////////
253    // ConfigFileManager //
254    ///////////////////////
255    class _CoreExport ConfigFileManager
256    {
257        public:
258            static ConfigFileManager* getInstance();
259
260            void setFile(ConfigFileType type, const std::string& filename, bool bCreateIfNotExisting = true);
261
262            void load(bool bCreateIfNotExisting = true);
263            void save();
264            void clean(bool bCleanComments = false);
265
266            void load(ConfigFileType type, bool bCreateIfNotExisting = true);
267            void save(ConfigFileType type);
268            void save(ConfigFileType type, const std::string& filename);
269            void clean(ConfigFileType type, bool bCleanComments = false);
270
271            inline void setValue(ConfigFileType type, const std::string& section, const std::string& name, const std::string& value, bool bString)
272                { this->getFile(type)->setValue(section, name, value, bString); }
273            inline std::string getValue(ConfigFileType type, const std::string& section, const std::string& name, const std::string& fallback, bool bString)
274                { return this->getFile(type)->getValue(section, name, fallback, bString); }
275
276            inline void setValue(ConfigFileType type, const std::string& section, const std::string& name, unsigned int index, const std::string& value, bool bString)
277                { this->getFile(type)->setValue(section, name, index, value, bString); }
278            inline std::string getValue(ConfigFileType type, const std::string& section, const std::string& name, unsigned int index, const std::string& fallback, bool bString)
279                { return this->getFile(type)->getValue(section, name, index, fallback, bString); }
280
281            inline void deleteVectorEntries(ConfigFileType type, const std::string& section, const std::string& name, unsigned int startindex = 0)
282                { this->getFile(type)->deleteVectorEntries(section, name, startindex); }
283            inline unsigned int getVectorSize(ConfigFileType type, const std::string& section, const std::string& name)
284                { return this->getFile(type)->getVectorSize(section, name); }
285
286            void updateConfigValues() const;
287            void updateConfigValues(ConfigFileType type) const;
288
289        private:
290            ConfigFileManager();
291            ConfigFileManager(const ConfigFileManager& other);
292            ~ConfigFileManager();
293
294            ConfigFile* getFile(ConfigFileType type);
295
296            std::string getFilePath(const std::string& name) const;
297
298            std::map<ConfigFileType, ConfigFile*> configFiles_;
299    };
300}
301
302#endif /* _ConfigFileManager_H__ */
Note: See TracBrowser for help on using the repository browser.