BxDomParser.h

// ##################################################################
// Binx
// $Id: BxDomParser_8h-source.html,v 1.1.1.1 2006/04/19 14:19:02 edikt2 Exp $
//
// BxDomParser is a wrapper around a third-party DOM parser.
// ##################################################################
/*

//  edikt::BinX
//  www.edikt.org
//  support@edikt.org

// Copyright (c) 2003 The University of Edinburgh.

*/


#ifndef __BxDomParser__
#define __BxDomParser__

#include <xercesc/util/PlatformUtils.hpp>
#include <xercesc/util/XMLString.hpp>
#include <xercesc/dom/DOM.hpp>

#include "BxObject.h"
#include "BxDomNodeList.h"
#include "BxDomAttributeList.h"
#include "BxDomErrorHandler.h"

XERCES_CPP_NAMESPACE_USE

/*
 * Class implementing a wrapper for a third party DOM parser.
 * The current implementation is specific to the Xerces DOM parser.
 * The methods provided by this class are used by the class BxBinxFile
 * to read and parse the contents of a BinX document file.
 * <BR>Future versions of the BinX library may use a different DOM parser.
 * Only this class needs to be rewritten.
 */
class DECLSPEC BxDomParser : public BxObject
{
    BxDomErrorHandler * errorHandler_; //<error handler
    bool errorOccurred_; //<whether has error during parsing

    DOMBuilder * parser_;  //<a DOMBuilder object pointer
    DOMDocument * doc_;   //<DOMDocument object pointer
    DOMNode * rootNode_;  //< root element of the BinX file, should be <dataset>
    DOMNode * defNode_;     //< the <definitions> node

    int  binxVersion_;  //< 0=NON-BinX file, 1=1.0, 2=2.0, not implemented in this version of BinX

public:
    BxDomParser();
    BxDomParser(const char * xmlFilename);
    virtual ~BxDomParser();

    bool parse(const char * xmlFilename);
    bool hasErrors() const { return errorOccurred_; }
    bool isBinxFile() const;
    BxDomNodeList * getElements() { return new BxDomNodeList(rootNode_->getChildNodes()); }
    BxDomNodeList * getTypeDefinitions();  // return a pointer to a list of nodes under <definitions>
    BxDomNodeList * getTypeDefinitions(const char * tag);  // return a pointer to a list of nodes under <definitions>
    BxDomAttributeList * getDatasetAttributes(); // return pointer to list of attributes for <dataset>
    BxDomNodeList * getFiles(); //return a pointer to a list of nodes <file> under <dataset>

protected:
    virtual void init();
    virtual void terminate();
};


#endif

---