/data/refman/pasoursint/CMSSW_5_2_9/src/DetectorDescription/Parser/src/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/Base/interface/DDException.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