DDXMLElement.h

Go to the documentation of this file.

#ifndef DD_XMLElement_H
#define DD_XMLElement_H
/***************************************************************************
 DDXMLElement.h  -  description
 -------------------
 begin                : Fri Mar 15 2002
 email                : case@ucdhep.ucdavis.edu
 ***************************************************************************/

// -------------------------------------------------------------------------
// Includes
// -------------------------------------------------------------------------

#include <map>
#include <string>
#include <vector>

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

#include "DetectorDescription/Parser/interface/DDLElementRegistry.h"

// -------------------------------------------------------------------------
// Class declaration
// -------------------------------------------------------------------------


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 );
   

   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:
   static std::string itostr( int i );
   
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