xml_config.hh

/*
** TowBowlTactics, an adaptation of the tabletop game Blood Bowl.
**
** Copyright (C) 2006 The TBT Team.
**
** This program is free software; you can redistribute it and/or
** modify it under the terms of the GNU General Public License
** as published by the Free Software Foundation; either version 2
** of the License, or (at your option) any later version.
**
** The complete GNU General Public Licence Notice can be found as the
** `NOTICE' file in the root directory.
**
** The TBT Team consists of people listed in the `AUTHORS' file.
*/

#ifndef XML_CONFIG_HH_
# define XML_CONFIG_HH_

# include "xml/xml.hh"

BEGIN_NS(xml);

class XMLConfig : public XML
{
public:
  XMLConfig(const std::string& def_file, const std::string& def_loc);
  
  void switchClientSection(int client_gid) const;

  template <typename T>
  T getData(const std::string& section_name,
        const std::string& node_name) const;

  template <typename T>
  T getAttr(const std::string& section_name,
        const std::string& node_name,
        const std::string& attr_name) const;

  template <typename T>
  void setData(const std::string& section_name,
           const std::string& node_name,
           const T& value);

  template <typename T>
  void setAttr(const std::string& section_name,
           const std::string& node_name,
           const std::string& attr_name,
           const T& value);
  
  virtual void parse(const std::string& filename);

private:
  virtual const char* getExpectedRoot() const;

  bool switchToSection(const std::string& section_name, bool first_time) const;
  mutable std::string client_section_;
  std::string default_file_;
  std::string default_location_;
};

template <typename T>
inline T XMLConfig::getData(const std::string& section_name,
                const std::string& node_name) const
{
  switchToSection(section_name, true);
  try {
    return XML::getData<T>(node_name);
  } catch (const XMLError&) {
    if (!switchToSection(section_name, false))
      throw;
    return XML::getData<T>(node_name);
  }
}

template <typename T>
inline T XMLConfig::getAttr(const std::string& section_name,
                const std::string& node_name,
                const std::string& attr_name) const
{
  switchToSection(section_name, true);
  try {
    return XML::getAttr<T>(node_name, attr_name);
  } catch (const XMLError&) {
    if (!switchToSection(section_name, false))
      throw;
    return XML::getAttr<T>(node_name, attr_name);
  }
}

template <typename T>
inline void XMLConfig::setData(const std::string& section_name,
                   const std::string& node_name,
                   const T& value)
{
  try {
    // if the data exists in specific section, write it here.
    switchToSection(section_name, true);
    XML::getData<T>(node_name);
    XML::setData<T>(node_name, value);
  } catch (const XMLError&) {
    // if the data exists in generic section, write it here.
    try {
      switchToSection(section_name, false);
      XML::getData<T>(node_name);
      XML::setData<T>(node_name, value);
    } catch (const XMLError&) {
      // was not present before. write it in specific section.
      switchToSection(section_name, true);
      XML::setData<T>(node_name, value);
    }
  }
  
  switchToSection(section_name, true);
}

template <typename T>
inline void XMLConfig::setAttr(const std::string& section_name,
            const std::string& node_name,
            const std::string& attr_name,
            const T& value)
{
  try {
    // if the attribute exists in specific section, write it here.
    switchToSection(section_name, true);
    XML::getAttr<T>(node_name, attr_name);
    XML::setAttr<T>(node_name, attr_name, value);
  } catch (const XMLError&) {
    // if the attribute exists in generic section, write it here.
    try {
      switchToSection(section_name, false);
      XML::getAttr<T>(node_name, attr_name);
      XML::setAttr<T>(node_name, attr_name, value);
    } catch (const XMLError&) {
      // was not present before. write it in specific section.
      switchToSection(section_name, true);
      XML::setAttr<T>(node_name, attr_name, value);
    }
  }
}

END_NS(xml);

#endif /* !XML_CONFIG_HH_ */

---