Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/buildsystem3/src/core/ConfigFileManager.cc @ 2685

Last change on this file since 2685 was 2685, checked in by rgrieder, 15 years ago

Fixed install target:

  • log and config file go a to separate folder each
  • The SignalHandler crash log is now "orxonox_crash.log" to avoid opening the file twice which might result in problems
  • moved tcl scripts to media/tcl8.#/ as a temporary solution. I've also created a ticket to fix this.
  • UPDATE YOUR MEDIA REPOSITORY
  • orxonox.log pre-main gets written to either %TEMP% (windows) or /tmp (Unix) and when the path was set, the content is copied.
  • removed Settings class and moved media path to Core
  • media, log and config path are now all in Core where only the media path can be configured via ini file or command line
  • Core::isDevBuild() tells whether we are running in the build or the installation directory (determined by the presence of "orxonox_dev_build.kepp_me" in the binary dir)
  • renamed Settings::getDataPath to Core::getMediaPath
  • Property svn:eol-style set to native
File size: 20.9 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#include "ConfigFileManager.h"
30
31#include <cassert>
32#include <boost/filesystem.hpp>
33
34#include "util/Convert.h"
35#include "util/String.h"
36#include "ConsoleCommand.h"
37#include "ConfigValueContainer.h"
38#include "Core.h"
39
40namespace orxonox
41{
42    const int CONFIG_FILE_MAX_LINELENGHT  = 1024;
43    const char* const DEFAULT_CONFIG_FILE = "default.ini";
44
45    ConfigFileManager* ConfigFileManager::singletonRef_s = 0;
46
47    SetConsoleCommandShortcutExtern(config).argumentCompleter(0, autocompletion::configvalueclasses()).argumentCompleter(1, autocompletion::configvalues()).argumentCompleter(2, autocompletion::configvalue());
48    SetConsoleCommandShortcutExtern(tconfig).argumentCompleter(0, autocompletion::configvalueclasses()).argumentCompleter(1, autocompletion::configvalues()).argumentCompleter(2, autocompletion::configvalue());
49    SetConsoleCommandShortcutExtern(reloadConfig);
50    SetConsoleCommandShortcutExtern(cleanConfig);
51    SetConsoleCommandShortcutExtern(loadSettings).argumentCompleter(0, autocompletion::files());
52
53    bool config(const std::string& classname, const std::string& varname, const std::string& value)
54    {
55        std::map<std::string, Identifier*>::const_iterator identifier = Identifier::getLowercaseIdentifierMap().find(getLowercase(classname));
56        if (identifier != Identifier::getLowercaseIdentifierMapEnd())
57        {
58            std::map<std::string, ConfigValueContainer*>::const_iterator variable = (*identifier).second->getLowercaseConfigValueMap().find(getLowercase(varname));
59            if (variable != (*identifier).second->getLowercaseConfigValueMapEnd())
60                return (*variable).second->set(value);
61        }
62        return false;
63    }
64
65    bool tconfig(const std::string& classname, const std::string& varname, const std::string& value)
66    {
67        std::map<std::string, Identifier*>::const_iterator identifier = Identifier::getLowercaseIdentifierMap().find(getLowercase(classname));
68        if (identifier != Identifier::getLowercaseIdentifierMapEnd())
69        {
70            std::map<std::string, ConfigValueContainer*>::const_iterator variable = (*identifier).second->getLowercaseConfigValueMap().find(getLowercase(varname));
71            if (variable != (*identifier).second->getLowercaseConfigValueMapEnd())
72                return (*variable).second->tset(value);
73        }
74        return false;
75    }
76
77    void reloadConfig()
78    {
79        ConfigFileManager::getInstance().load();
80    }
81
82    void cleanConfig()
83    {
84        ConfigFileManager::getInstance().clean(false);
85    }
86
87    void loadSettings(const std::string& filename)
88    {
89        ConfigFileManager::getInstance().setFilename(ConfigFileType::Settings, filename);
90    }
91
92    //////////////////////////
93    // ConfigFileEntryValue //
94    //////////////////////////
95
96    void ConfigFileEntryValue::setValue(const std::string& value)
97    {
98        if (!this->bString_)
99            this->value_ = value;
100        else
101            this->value_ = "\"" + addSlashes(stripEnclosingQuotes(value)) + "\"";
102    }
103
104    std::string ConfigFileEntryValue::getValue() const
105    {
106        if (!this->bString_)
107            return this->value_;
108        else
109            return removeSlashes(stripEnclosingQuotes(this->value_));
110    }
111
112    std::string ConfigFileEntryValue::getFileEntry() const
113    {
114        if (this->additionalComment_ == "" || this->additionalComment_.size() == 0)
115            return (this->name_ + "=" + this->value_);
116        else
117            return (this->name_ + "=" + this->value_ + " " + this->additionalComment_);
118    }
119
120
121    ////////////////////////////////
122    // ConfigFileEntryVectorValue //
123    ////////////////////////////////
124    std::string ConfigFileEntryVectorValue::getFileEntry() const
125    {
126        if (this->additionalComment_ == "" || this->additionalComment_.size() == 0)
127            return (this->name_ + "[" + getConvertedValue<unsigned int, std::string>(this->index_, "0") + "]" + "=" + this->value_);
128        else
129            return (this->name_ + "[" + getConvertedValue<unsigned int, std::string>(this->index_, "0") + "]=" + this->value_ + " " + this->additionalComment_);
130    }
131
132
133    ///////////////////////
134    // ConfigFileSection //
135    ///////////////////////
136    ConfigFileSection::~ConfigFileSection()
137    {
138        for (std::list<ConfigFileEntry*>::iterator it = this->entries_.begin(); it != this->entries_.end(); )
139            delete (*(it++));
140    }
141
142    void ConfigFileSection::deleteVectorEntries(const std::string& name, unsigned int startindex)
143    {
144        for (std::list<ConfigFileEntry*>::iterator it = this->entries_.begin(); it != this->entries_.end(); )
145        {
146            if (((*it)->getName() == name) && ((*it)->getIndex() >= startindex))
147            {
148                delete (*it);
149                this->entries_.erase(it++);
150            }
151            else
152            {
153                ++it;
154            }
155        }
156    }
157
158    unsigned int ConfigFileSection::getVectorSize(const std::string& name)
159    {
160        unsigned int size = 0;
161        for (std::list<ConfigFileEntry*>::const_iterator it = this->entries_.begin(); it != this->entries_.end(); ++it)
162            if ((*it)->getName() == name)
163                if ((*it)->getIndex() > size)
164                    size = (*it)->getIndex();
165        if (size == 0)
166            return 0;
167        else
168            return (size + 1);
169    }
170
171    std::string ConfigFileSection::getFileEntry() const
172    {
173        if (this->additionalComment_ == "" || this->additionalComment_.size() == 0)
174            return ("[" + this->name_ + "]");
175        else
176            return ("[" + this->name_ + "] " + this->additionalComment_);
177    }
178
179    std::list<ConfigFileEntry*>::iterator ConfigFileSection::getEntryIterator(const std::string& name, const std::string& fallback, bool bString)
180    {
181        for (std::list<ConfigFileEntry*>::iterator it = this->entries_.begin(); it != this->entries_.end(); ++it)
182        {
183            if ((*it)->getName() == name)
184            {
185                (*it)->setString(bString);
186                return it;
187            }
188        }
189
190        this->bUpdated_ = true;
191
192        return this->entries_.insert(this->entries_.end(), (ConfigFileEntry*)(new ConfigFileEntryValue(name, fallback, bString)));
193    }
194
195    std::list<ConfigFileEntry*>::iterator ConfigFileSection::getEntryIterator(const std::string& name, unsigned int index, const std::string& fallback, bool bString)
196    {
197        for (std::list<ConfigFileEntry*>::iterator it = this->entries_.begin(); it != this->entries_.end(); ++it)
198        {
199            if (((*it)->getName() == name) && ((*it)->getIndex() == index))
200            {
201                (*it)->setString(bString);
202                return it;
203            }
204        }
205
206        this->bUpdated_ = true;
207
208        if (index == 0)
209            return this->entries_.insert(this->entries_.end(), (ConfigFileEntry*)(new ConfigFileEntryVectorValue(name, index, fallback, bString)));
210        else
211            return this->entries_.insert(++this->getEntryIterator(name, index - 1, "", bString), (ConfigFileEntry*)(new ConfigFileEntryVectorValue(name, index, fallback, bString)));
212    }
213
214
215    ////////////////
216    // ConfigFile //
217    ////////////////
218    ConfigFile::~ConfigFile()
219    {
220        this->clear();
221    }
222
223    void ConfigFile::load(bool bCreateIfNotExisting)
224    {
225        // Be sure we start from new
226        this->clear();
227
228        boost::filesystem::path filepath(Core::getConfigPath() + "/" + this->filename_);
229
230        // This creates the config file if it's not existing
231        std::ofstream createFile;
232        createFile.open(filepath.native_file_string().c_str(), std::fstream::app);
233        createFile.close();
234
235        // Open the file
236        std::ifstream file;
237        file.open(filepath.native_file_string().c_str(), std::fstream::in);
238
239        if (!file.is_open())
240        {
241            COUT(1) << "An error occurred in ConfigFileManager.cc:" << std::endl;
242            COUT(1) << "Error: Couldn't open config-file \"" << this->filename_ << "\"." << std::endl;
243            return;
244        }
245
246        char linearray[CONFIG_FILE_MAX_LINELENGHT];
247
248        ConfigFileSection* newsection = 0;
249
250        while (file.good() && !file.eof())
251        {
252            file.getline(linearray, CONFIG_FILE_MAX_LINELENGHT);
253
254            std::string line = std::string(linearray);
255
256            std::string temp = getStripped(line);
257            if (!isEmpty(temp) && !isComment(temp))
258            {
259                size_t   pos1 = temp.find('[');
260                if (pos1 == 0) pos1 = line.find('['); else pos1 = std::string::npos;
261                size_t   pos2 = line.find(']');
262
263                if (pos1 != std::string::npos && pos2 != std::string::npos && pos2 > pos1 + 1)
264                {
265                    // New section
266                    std::string comment = line.substr(pos2 + 1);
267                    if (isComment(comment))
268                        newsection = new ConfigFileSection(line.substr(pos1 + 1, pos2 - pos1 - 1), comment);
269                    else
270                        newsection = new ConfigFileSection(line.substr(pos1 + 1, pos2 - pos1 - 1));
271                    this->sections_.insert(this->sections_.end(), newsection);
272                    continue;
273                }
274            }
275
276            if (newsection != 0)
277            {
278                if (isComment(line))
279                {
280                    // New comment
281                    newsection->getEntries().insert(newsection->getEntries().end(), new ConfigFileEntryComment(removeTrailingWhitespaces(line)));
282                    continue;
283                }
284                else
285                {
286                    size_t pos1 = line.find('=');
287
288                    if (pos1 != std::string::npos && pos1 > 0)
289                    {
290                        // New entry
291                        size_t pos2 = line.find('[');
292                        size_t pos3 = line.find(']');
293                        size_t commentposition = getNextCommentPosition(line, pos1 + 1);
294                        while (isBetweenQuotes(line, commentposition))
295                        {
296                            commentposition = getNextCommentPosition(line, commentposition + 1);
297                        }
298                        std::string value = "", comment = "";
299                        if (commentposition == std::string::npos)
300                        {
301                            value = removeTrailingWhitespaces(line.substr(pos1 + 1));
302                        }
303                        else
304                        {
305                            value = removeTrailingWhitespaces(line.substr(pos1 + 1, commentposition - pos1 - 1));
306                            comment = removeTrailingWhitespaces(line.substr(commentposition));
307                        }
308
309                        if (pos2 != std::string::npos && pos3 != std::string::npos && pos3 > pos2 + 1)
310                        {
311                            // There might be an array index
312                            unsigned int index = 0;
313                            if (ConvertValue(&index, line.substr(pos2 + 1, pos3 - pos2 - 1)))
314                            {
315                                // New array
316                                std::list<ConfigFileEntry*>::iterator it = newsection->getEntryIterator(getStripped(line.substr(0, pos2)), index, value, false);
317                                (*it)->setValue(value);
318                                (*it)->setComment(comment);
319                                continue;
320                            }
321                        }
322
323                        // New value
324                        newsection->getEntries().insert(newsection->getEntries().end(), new ConfigFileEntryValue(getStripped(line.substr(0, pos1)), value, false, comment));
325                        continue;
326                    }
327                }
328            }
329        }
330
331        file.close();
332
333        COUT(3) << "Loaded config file \"" << this->filename_ << "\"." << std::endl;
334
335        // Save the file in case something changed (like stripped whitespaces)
336        this->save();
337
338        // Update all ConfigValueContainers
339        this->updateConfigValues();
340    }
341
342    void ConfigFile::save() const
343    {
344        boost::filesystem::path filepath(Core::getConfigPath() + "/" + this->filename_);
345
346        std::ofstream file;
347        file.open(filepath.native_file_string().c_str(), std::fstream::out);
348        file.setf(std::ios::fixed, std::ios::floatfield);
349        file.precision(6);
350
351        if (!file.is_open())
352        {
353            COUT(1) << "An error occurred in ConfigFileManager.cc:" << std::endl;
354            COUT(1) << "Error: Couldn't open config-file \"" << this->filename_ << "\"." << std::endl;
355            return;
356        }
357
358        for (std::list<ConfigFileSection*>::const_iterator it = this->sections_.begin(); it != this->sections_.end(); ++it)
359        {
360            file << (*it)->getFileEntry() << std::endl;
361
362            for (std::list<ConfigFileEntry*>::const_iterator it_entries = (*it)->getEntriesBegin(); it_entries != (*it)->getEntriesEnd(); ++it_entries)
363            {
364                file << (*it_entries)->getFileEntry() << std::endl;
365            }
366
367            file << std::endl;
368        }
369
370        file.close();
371
372        COUT(4) << "Saved config file \"" << this->filename_ << "\"." << std::endl;
373    }
374
375    void ConfigFile::saveAs(const std::string& filename)
376    {
377        std::string temp = this->filename_;
378        this->filename_ = filename;
379        this->save();
380        this->filename_ = temp;
381    }
382
383    void ConfigFile::clean(bool bCleanComments)
384    {
385        for (std::list<ConfigFileSection*>::iterator it1 = this->sections_.begin(); it1 != this->sections_.end(); )
386        {
387            std::map<std::string, Identifier*>::const_iterator it2 = Identifier::getIdentifierMap().find((*it1)->getName());
388            if (it2 != Identifier::getIdentifierMapEnd() && (*it2).second->hasConfigValues())
389            {
390                // The section exists, delete comment
391                if (bCleanComments)
392                    (*it1)->setComment("");
393                for (std::list<ConfigFileEntry*>::iterator it3 = (*it1)->entries_.begin(); it3 != (*it1)->entries_.end(); )
394                {
395                    std::map<std::string, ConfigValueContainer*>::const_iterator it4 = (*it2).second->getConfigValueMap().find((*it3)->getName());
396                    if (it4 != (*it2).second->getConfigValueMapEnd())
397                    {
398                        // The config-value exists, delete comment
399                        if (bCleanComments)
400                            (*it3)->setComment("");
401                        ++it3;
402                    }
403                    else
404                    {
405                        // The config-value doesn't exist
406                        delete (*it3);
407                        (*it1)->entries_.erase(it3++);
408                    }
409                }
410                ++it1;
411            }
412            else
413            {
414                // The section doesn't exist
415                delete (*it1);
416                this->sections_.erase(it1++);
417            }
418        }
419
420        // Save the file
421        this->save();
422    }
423
424    void ConfigFile::clear()
425    {
426        for (std::list<ConfigFileSection*>::iterator it = this->sections_.begin(); it != this->sections_.end(); )
427            delete (*(it++));
428        this->sections_.clear();
429    }
430
431    ConfigFileSection* ConfigFile::getSection(const std::string& section)
432    {
433        for (std::list<ConfigFileSection*>::iterator it = this->sections_.begin(); it != this->sections_.end(); ++it)
434            if ((*it)->getName() == section)
435                return (*it);
436
437        this->bUpdated_ = true;
438
439        return (*this->sections_.insert(this->sections_.end(), new ConfigFileSection(section)));
440    }
441
442    void ConfigFile::saveIfUpdated()
443    {
444        bool sectionsUpdated = false;
445
446        for (std::list<ConfigFileSection*>::iterator it = this->sections_.begin(); it != this->sections_.end(); ++it)
447        {
448            if ((*it)->bUpdated_)
449            {
450                sectionsUpdated = true;
451                (*it)->bUpdated_ = false;
452            }
453        }
454
455        if (this->bUpdated_ || sectionsUpdated)
456        {
457            this->bUpdated_ = false;
458            this->save();
459        }
460    }
461
462    void ConfigFile::updateConfigValues()
463    {
464        if (this->type_ == ConfigFileType::Settings)
465        {
466            for (std::map<std::string, Identifier*>::const_iterator it = Identifier::getIdentifierMapBegin(); it != Identifier::getIdentifierMapEnd(); ++it)
467            {
468                if (it->second->hasConfigValues())
469                {
470                    for (std::map<std::string, ConfigValueContainer*>::const_iterator it2 = (*it).second->getConfigValueMapBegin(); it2 != (*it).second->getConfigValueMapEnd(); ++it2)
471                        it2->second->update();
472
473                    it->second->updateConfigValues();
474                }
475            }
476        }
477    }
478
479
480    ///////////////////////
481    // ConfigFileManager //
482    ///////////////////////
483
484    ConfigFileManager::ConfigFileManager()
485         : mininmalFreeType_(ConfigFileType::numberOfReservedTypes)
486    {
487        assert(singletonRef_s == 0);
488        singletonRef_s = this;
489    }
490
491    ConfigFileManager::~ConfigFileManager()
492    {
493        for(std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.begin(); it != this->configFiles_.end(); )
494            delete (it++)->second;
495
496        assert(singletonRef_s != 0);
497        singletonRef_s = 0;
498    }
499
500    void ConfigFileManager::setFilename(ConfigFileType type, const std::string& filename)
501    {
502        std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.find(type);
503        if (it != this->configFiles_.end())
504        {
505            assert(it->second);
506            delete it->second;
507        }
508        this->configFiles_[type] = new ConfigFile(filename, type);
509        this->load(type);
510    }
511
512    void ConfigFileManager::load()
513    {
514        for(std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.begin(); it != this->configFiles_.end(); ++it)
515            it->second->load();
516    }
517
518    void ConfigFileManager::save()
519    {
520        for(std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.begin(); it != this->configFiles_.end(); ++it)
521            it->second->save();
522    }
523
524    void ConfigFileManager::clean(bool bCleanComments)
525    {
526        for(std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.begin(); it != this->configFiles_.end(); ++it)
527            this->clean(it->first, bCleanComments);
528    }
529
530    void ConfigFileManager::load(ConfigFileType type)
531    {
532        this->getFile(type)->load();
533    }
534
535    void ConfigFileManager::save(ConfigFileType type)
536    {
537        this->getFile(type)->save();
538    }
539
540    void ConfigFileManager::saveAs(ConfigFileType type, const std::string& saveFilename)
541    {
542        this->getFile(type)->saveAs(saveFilename);
543    }
544
545    void ConfigFileManager::clean(ConfigFileType type, bool bCleanComments)
546    {
547        this->getFile(type)->clean(bCleanComments);
548    }
549
550    void ConfigFileManager::updateConfigValues()
551    {
552        for(std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.begin(); it != this->configFiles_.end(); ++it)
553            it->second->updateConfigValues();
554    }
555
556    void ConfigFileManager::updateConfigValues(ConfigFileType type)
557    {
558        this->getFile(type)->updateConfigValues();
559    }
560
561    const std::string& ConfigFileManager::getFilename(ConfigFileType type)
562    {
563        std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.find(type);
564        if (it != this->configFiles_.end())
565            return it->second->getFilename();
566        else
567            return BLANKSTRING;
568    }
569
570    ConfigFile* ConfigFileManager::getFile(ConfigFileType type)
571    {
572        std::map<ConfigFileType, ConfigFile*>::const_iterator it = this->configFiles_.find(type);
573        if (it != this->configFiles_.end())
574            return it->second;
575        else
576        {
577            COUT(1) << "ConfigFileManager: Can't find a config file for type with ID " << (int)type << std::endl;
578            COUT(1) << "Using " << DEFAULT_CONFIG_FILE << " file." << std::endl;
579            this->setFilename(type, DEFAULT_CONFIG_FILE);
580            return getFile(type);
581        }
582    }
583}
Note: See TracBrowser for help on using the repository browser.