C:/Users/CAVM/Desktop/EOCFI-4.16-FAT/DOC_FIX/EOCFI_CPPLIB_4X/lib_src/FileHandling/include/XmlFile.h

//--------------------------------------------------------
// Earth Observation Mission CFI Software. Version 4.16
//--------------------------------------------------------


#ifndef _XMLFILE_H
#define _XMLFILE_H


#include <string>
#include <vector>

#include "CfiClass.h"
#include "CfiError.h"
#include "FixedHeader.h"
#include "FileHandlingData.h"

using namespace std;

namespace EECFI
{
   
   class XF_DECL XmlFile:public CfiClass
   {
      public:
      
         XmlFile(); 
         
         XmlFile(string fileNam) throw (CfiError);
         
         ~XmlFile() throw (CfiError);

         // Methods for creating, reading and writing

         void create() throw (CfiError);
         
         void read(const string fileNam) throw (CfiError);
         
         void write() throw (CfiError);
         
         void write(const string fileNam) throw (CfiError);
         
         void clean() throw (CfiError);

         // Methods for navigating the tree

         void root() throw (CfiError);
         
         void next() throw (CfiError);
         
         void nextSibling() const;
         
         void toElement(const string element) throw (CfiError);
         
         void toPath(const string path) throw (CfiError);
         
         string currentElementName() throw (CfiError);
         
         string currentPathName() throw (CfiError);

         // Methods for reading data

         string getElementValueAsString(const string element) throw (CfiError);
         
         long getElementValueAsInt(const string element) throw (CfiError);
         
         double getElementValueAsReal(const string element) throw (CfiError);
         
         vector<string> & getElementArrayAsString(const string element,
                                                  vector<string> &outVector) throw (CfiError);

         vector<long> & getElementArrayAsInt(const string element,
                                             vector<long> &outVector) throw (CfiError);

         vector<double> & getElementArrayAsReal(const string element,
                                                vector<double> &outVector) throw (CfiError);

         string getAttributeValueAsString(const string element,
                                          const string attribute) throw (CfiError);

         long getAttributeValueAsInt(const string element,
                                     const string attribute) throw (CfiError);

         double getAttributeValueAsReal(const string element,
                                        const string attribute) throw (CfiError);

         string getPathValueAsString(const string path) throw (CfiError);
         
         long getPathValueAsInt(const string path) throw (CfiError);
         
         double getPathValueAsReal(const string path) throw (CfiError);
         
         vector<string> & getPathArrayAsString(const string node,
                                               vector<string> &outVector) throw (CfiError);

         vector<long> & getPathArrayAsInt(const string node,
                                          vector<long> &outVector) throw (CfiError);

         vector<double> & getPathArrayAsReal(const string node,
                                             vector<double> &outVector) throw (CfiError);

         // Methods for adding and removing nodes

         void createRoot(const string element) throw (CfiError);
         
         void addChild(const string parent,
                       const string child) throw (CfiError);

         void addNext(const string current,
                      const string next) throw (CfiError);

         void addPrevious(const string current,
                          const string previous) throw (CfiError);

         void addAttribute(const string element,
                           const string attribute) throw (CfiError);
                        
         void copyNode(const string destPath,
                       const string sourceXmlFile,
                       const string sourcePath) throw (CfiError);

         void removeNode(const string path) throw (CfiError);

         // Methods for setting values

         void setValue(const string path,
                       const string value,
                       const string format) throw (CfiError);

         void setValue(const string path,
                       const long value,
                       const string format) throw (CfiError);

         void setValue(const string path,
                       const double value,
                       const string format) throw (CfiError);

         // Methods for adding nodes with values

         void addChild(const string parent,
                       const string child,
                       const string value,
                       const string format) throw (CfiError);

         void addChild(const string parent,
                       const string child,
                       const long value,
                       const string format) throw (CfiError);

         void addChild(const string parent,
                       const string child,
                       const double value,
                       const string format) throw (CfiError);

         void addNext(const string current,
                      const string next,
                      const string value,
                      const string format) throw (CfiError);

         void addNext(const string current,
                      const string next,
                      const long value,
                      const string format) throw (CfiError);

         void addNext(const string current,
                      const string next,
                      const double value,
                      const string format) throw (CfiError);

         void addPrevious(const string current,
                          const string previous,
                          const string value,
                          const string format) throw (CfiError);

         void addPrevious(const string current,
                          const string previous,
                          const long value,
                          const string format) throw (CfiError);

         void addPrevious(const string current,
                          const string previous,
                          const double value,
                          const string format) throw (CfiError);

         void addAttribute(const string element,
                           const string attribute,
                           const string value,
                           const string format) throw (CfiError);

         void addAttribute(const string element,
                           const string attribute,
                           const long value,
                           const string format) throw (CfiError);

         void addAttribute(const string element,
                           const string attribute,
                           const double value,
                           const string format) throw (CfiError);

         // Methods for searching elements by value

         string findValueInElement(const string element,
                                   const string value) throw (CfiError);

         string findValueInPath(const string path,
                                const string value) throw (CfiError);
      
         // Methods for handling the file header
      
         void createHeader(long fileExtensionType) throw (CfiError);

         void createHeader(FixedHeader &xmlHeader) throw (CfiError);
         
         string createFileName(long satelliteId,
                               string fileClass,
                               string fileType,
                               string instanceId,
                               long fileExtensionType) throw (CfiError);

         FileNameItems getFileNameItems(string fileNam) throw (CfiError);

         void setFixedHeaderItem(const string itemName,
                                 const string itemValue) throw (CfiError);

         void setFixedHeaderItems(const string fileNam,
                                  const string fileDescription,
                                  const string notes,
                                  const string mission,
                                  const string fileClass,
                                  const string filetype,
                                  const string validityStart, 
                                  const string validityStop,
                                  const long   fileVersion,
                                  const string system,
                                  const string creator,
                                  const string creatorVersion,
                                  const string creationDate) throw (CfiError);

         string getFixedHeaderItem(const string itemName) throw (CfiError);
         
         FixedHeader getFixedHeader() throw (CfiError);
         
         long getId() const;
         
         string getFileName() const;
         
         void setSchema( const string schemaName, bool setAll);
         
         void removeSchema( bool removeAll);
         
         vector<string>& getStringValuesFromList(const string listPath, 
                                                 const string element, 
                                                 vector <string> &outVector) throw (CfiError);      

      protected:

      private:
         long id;         
         string fileName; 


  };//class XmlFile
}//namespace EECFI

#endif