parser.hh

Go to the documentation of this file.

// Copyright (c) 2014, LAAS-CNRS
// Authors: Joseph Mirabel (joseph.mirabel@laas.fr)
//
 
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
//
// 2. Redistributions in binary form must reproduce the above copyright
// notice, this list of conditions and the following disclaimer in the
// documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
// DAMAGE.
 
#ifndef HPP_MANIPULATION_PARSER_HH
#define HPP_MANIPULATION_PARSER_HH
 
#include <tinyxml2.h>
 
#include <functional>
#include <iostream>
#include <list>
#include <map>
#include <string>
 
namespace hpp {
namespace util {
namespace parser {
typedef tinyxml2::XMLElement XMLElement;
typedef tinyxml2::XMLDocument XMLDocument;
typedef tinyxml2::XMLDeclaration XMLDeclaration;
typedef tinyxml2::XMLAttribute XMLAttribute;
typedef tinyxml2::XMLNode XMLNode;
typedef tinyxml2::XMLText XMLText;
typedef tinyxml2::XMLComment XMLComment;
 
typedef tinyxml2::XMLPrinter XMLPrinter;
 
class RootFactory;
 
 
 
class ObjectFactory {
 public:
  typedef std::list<ObjectFactory*> ObjectFactoryList;
 
  ObjectFactory(ObjectFactory* parent = NULL, const XMLElement* element = NULL);
 
  virtual ~ObjectFactory() {}
 
  virtual bool init();
 
  void setAttribute(const XMLAttribute* attr);
 
  virtual void addTextChild(const XMLText* text);
 
  virtual bool finishAttributes();
 
  virtual void finishTags();
 
  virtual void finishFile();
 
 
 
  ObjectFactory(const std::string& tagName, ObjectFactory* parent = NULL);
 
  void addAttribute(const std::string& name, const std::string& value);
 
  XMLNode* write(XMLNode* node) const;
 
 
 
  std::string tagName() const;
 
  std::string name() const;
 
  bool hasAttribute(const std::string& attr) const;
 
  std::string getAttribute(const std::string& attr) const;
 
  ObjectFactoryList getChildrenOfType(std::string type);
 
  bool getChildOfType(std::string type, ObjectFactory*& o);
 
 
  void name(const std::string& n);
 
  void name(const char* n);
 
  template <typename T>
  T* as() {
    return static_cast<T*>(this);
  }
 
 protected:
  ObjectFactory(ObjectFactory* root);
 
  ObjectFactory* parent();
 
  virtual ObjectFactory* root();
 
  bool hasParent() const;
 
  const XMLElement* XMLelement();
 
  virtual void impl_setAttribute(const XMLAttribute* attr);
 
  virtual void impl_write(XMLElement* element) const;
 
  void addChild(ObjectFactory* child);
 
  virtual std::ostream& print(std::ostream& os) const;
 
 private:
  ObjectFactory* parent_;
  ObjectFactory* root_;
  typedef std::map<std::string, ObjectFactoryList> ChildrenMap;
  ChildrenMap children_;
 
  const XMLElement* element_;
 
  typedef std::map<std::string, std::string> AttributeMap;
  AttributeMap attrMap_;
  std::string name_, tagName_;
  int id_;
 
  friend std::ostream& operator<<(std::ostream&, const ObjectFactory&);
};
 
template <typename T>
ObjectFactory* create(ObjectFactory* parent = NULL,
                      const XMLElement* element = NULL) {
  return new T(parent, element);
}
 
class Parser {
 public:
  typedef std::function<ObjectFactory*(ObjectFactory*, const XMLElement*)>
      FactoryType;
 
  Parser(FactoryType defaultFactory = create<ObjectFactory>);
 
  virtual ~Parser();
 
  void addObjectFactory(const std::string& tagname, FactoryType factory);
 
  virtual void parse(const char* xmlString);
 
  virtual void parseFile(const std::string& filename);
 
  ObjectFactory* root() const;
 
 private:
  XMLDocument doc_;
  ObjectFactory* root_;
 
  bool checkError() const;
 
  void loadString(const char* xmlstring);
 
  void parse();
 
  void parseElement(const XMLElement* element, ObjectFactory* parent);
 
  typedef std::map<std::string, FactoryType> ObjectFactoryMap;
  typedef std::pair<std::string, FactoryType> ObjectFactoryPair;
  typedef std::pair<ObjectFactoryMap::iterator, bool> ObjectFactoryInsertRet;
  ObjectFactoryMap objFactoryMap_;
  FactoryType defaultFactory_;
 
  typedef std::list<ObjectFactory*> ObjectFactoryList;
  ObjectFactoryList objectFactories_;
 
  std::ostream& print(std::ostream&) const;
  friend std::ostream& operator<<(std::ostream&, const Parser&);
};
 
std::ostream& operator<<(std::ostream&, const ObjectFactory&);
std::ostream& operator<<(std::ostream&, const Parser&);
}  // namespace parser
}  // namespace util
}  // namespace hpp
 
#endif  //  HPP_MANIPULATION_PARSER_HH