DDXMLElement.h

Go to the documentation of this file.

#ifndef DD_XMLElement_H
#define DD_XMLElement_H

#include <cstddef>
#include <iosfwd>
#include <map>
#include <string>
#include <vector>

#include "DetectorDescription/Core/interface/DDCompactView.h"
#include "DetectorDescription/Core/interface/DDName.h"
#include "DetectorDescription/Parser/interface/DDLElementRegistry.h"

class DDCompactView;
class DDLElementRegistry;


typedef std::map<std::string, std::string> DDXMLAttribute;
typedef std::map<std::string, std::vector<std::string> > AttrAccumType;

class DDXMLElement {
  friend std::ostream& operator<<(std::ostream& os, const DDXMLElement& element);

public:
  DDXMLElement(DDLElementRegistry* myreg);

  DDXMLElement(DDLElementRegistry* myreg, const bool& clearme);

  virtual ~DDXMLElement(void) = default;  // inline


  void loadAttributes(const std::string& elemName,
                      const std::vector<std::string>& names,
                      const std::vector<std::string>& values,
                      const std::string& nmspace,
                      DDCompactView& cpv);


  void loadText(const std::string& inText);

  void appendText(const std::string& inText);

  const std::string getText(size_t tindex = 0) const;

  virtual bool gotText(void) const;

  virtual void clear(void);

  virtual const std::string& getAttribute(const std::string& name) const;

  virtual const DDXMLAttribute& getAttributeSet(size_t aIndex = 0) const;

  const virtual DDName getDDName(const std::string& defaultNS,
                                 const std::string& attname = std::string("name"),
                                 size_t aIndex = 0);

  /*   /// Gets the value of the name part of an attribute of the form ns:name. */
  /*   const virtual std::string getName(const std::string& attname, size_t aIndex = 0); */

  /*   /// Gets the namespace of an attribute of the form ns:name. */
  /*   virtual std::string getNameSpace(const std::string& defaultNS, const std::string& attname, size_t aIndex = 0); */

  virtual const std::string& get(const std::string& name, size_t aIndex = 0) const;

  virtual std::vector<std::string> getVectorAttribute(const std::string& name);

  virtual size_t size(void) const;

  virtual std::vector<DDXMLAttribute>::const_iterator begin(void);

  virtual std::vector<DDXMLAttribute>::const_iterator end(void);

  void setParent(const std::string& pename);

  void setSelf(const std::string& sename);

  const std::string& parent(void) const;


  virtual void processElement(const std::string& name, const std::string& nmspace, DDCompactView& cpv);


  virtual void preProcessElement(const std::string& name, const std::string& nmspace, DDCompactView& cpv);

  virtual void stream(std::ostream& os) const;

  std::vector<DDXMLAttribute>::const_iterator& operator++(int inc);

  virtual bool isEmpty(void) const;

  void throwError(const std::string& keyMessage) const;

protected:
  DDLElementRegistry* myRegistry_;

private:
  void appendAttributes(std::vector<std::string>& tv, const std::string& name);

  std::vector<DDXMLAttribute>
      attributes_;                      // std::vector of name-value std::map (i.e. multiple elements of the same type.
  std::vector<std::string> text_;       // accumulates text.. one per element of this type.
  AttrAccumType attributeAccumulator_;  // temporary holder for most recent accessed attributes_... remove later!
  bool autoClear_;
  std::vector<DDXMLAttribute>::const_iterator myIter_;
  std::string myElement_;
  std::string parentElement_;
};

#endif