BxDataBinxParser.h

// ##################################################################
// Binx
// $Id: BxDataBinxParser_8h-source.html,v 1.1.1.1 2006/04/19 14:19:02 edikt2 Exp $
//
// Class for splitting a DataBinx document into SchemaBinx + binary
// ##################################################################
/*

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

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

*/

#ifndef __BxDataBinxParser__
#define __BxDataBinxParser__

#include "BxDataset.h"
#include "BxSaxHandler.h"
#include "BxDataObjectStack.h"

/*
 * Parsing a DataBinx document through SAX engine.
 * This module relies on Xerces C++ SAX parser.  Because a DataBinx
 * document may be very large in size, it is better to use a SAX parser
 * rather than a DOM parser as the BinX document parser uses.
 * The result of parsing a DataBinx document is an in-memory dataset
 * structure which can be saved to a SchemaBinx document, and a binary
 * data file automatically generated while parsing.  The binary file
 * is then associated with the SchemaBinx dataset.  The filename of the
 * binary file consists of two parts, the first part is the DataBinx
 * filename without extension, and the second part is a sequence number
 * and the extension is .bin.  For example, databinx1.bin.
 */
class DECLSPEC BxDataBinxParser : public BxObject
{
public:
    BxDataBinxParser();
    virtual ~BxDataBinxParser();

    // event handlers for SaxHandler
    void startElement(const char* name);
    void endElement(const char* name);
    void startAttribute(const char* name, const char* value);
    void startText(const char* text);

    virtual char* className() const { return "BxDataBinxParser"; }

    bool parse(const char* databinx);
    void saveSchemaBinx(const char* filename, const char* binfilename = NULL);

    void print();   //internal testing use
    
private:
    void dispatchDataObject();
    void expandDimCountBuffer();
    void clearDimCounts();

    //member variables
    BxSaxHandler* pSaxHandler_;    //SAX parser object
    BxDataset* pDataset_;          //the root element object pointer
    PointerStack stack_;            //stack object
    bool bDataBinxFound_;           //whether databinx element found
    bool bArrayFirstLoop_;      //whether a new array in processing
    int* pDimCounts_;      //collection of ints to hold number of elements
    int nMaxDims_;          //max allowed elements in the collection
    int nDimUpperBound_;    //real number of elements - 1
    int nDimIndex_;         //current index to the collection
    char* sDiscriminantValue_; //temporary string for discriminantValue attribute
    BxBinaryFile* bfile_;          //binary file handle to save data content
};

#endif

---