GenericSAXHandler.h

Go to the documentation of this file.

/****************************************************************************/
// A handler which converts occuring elements and attributes into enums
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2011 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This program is free software; you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation; either version 2 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef GenericSAXHandler_h
#define GenericSAXHandler_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <string>
#include <map>
#include <stack>
#include <sstream>
#include <vector>
#include <xercesc/sax2/Attributes.hpp>
#include <xercesc/sax2/DefaultHandler.hpp>
#include <utils/common/UtilExceptions.h>
#include <utils/common/StringBijection.h>
#include "SUMOSAXAttributes.h"


// ===========================================================================
// xerces 2.2 compatibility
// ===========================================================================
#if defined(XERCES_HAS_CPP_NAMESPACE)
using namespace XERCES_CPP_NAMESPACE;
#endif


// ===========================================================================
// class definitions
// ===========================================================================
class GenericSAXHandler : public DefaultHandler {

public:
    GenericSAXHandler(
        StringBijection<int>::Entry* tags, int terminatorTag,
        StringBijection<int>::Entry* attrs, int terminatorAttr,
        const std::string& file);


    virtual ~GenericSAXHandler();


    void startElement(const XMLCh* const uri, const XMLCh* const localname,
                      const XMLCh* const qname, const Attributes& attrs);


    void characters(const XMLCh* const chars, const XERCES3_SIZE_t length);


    void endElement(const XMLCh* const uri, const XMLCh* const localname,
                    const XMLCh* const qname);


    void registerParent(const int tag, GenericSAXHandler* handler);


    void setFileName(const std::string& name) throw();


    const std::string& getFileName() const throw();




    void warning(const SAXParseException& exception) throw();


    void error(const SAXParseException& exception) throw(ProcessError);


    void fatalError(const SAXParseException& exception) throw(ProcessError);



protected:
    std::string buildErrorMessage(const SAXParseException& exception) throw();


    virtual void myStartElement(int element,
                                const SUMOSAXAttributes& attrs);


    virtual void myCharacters(int element,
                              const std::string& chars);


    virtual void myEndElement(int element);


private:
    XMLCh* convert(const std::string& name) const throw();


    int convertTag(const std::string& tag) const throw();


private:


    // the type of the map from ids to their unicode-string representation
    typedef std::map<int, XMLCh*> AttrMap;

    // the map from ids to their unicode-string representation
    AttrMap myPredefinedTags;

    std::map<int, std::string> myPredefinedTagsMML;




    // the type of the map that maps tag names to ints
    typedef std::map<std::string, int> TagMap;

    // the map of tag names to their internal numerical representation
    TagMap myTagMap;

    std::vector<std::string> myCharactersVector;

    GenericSAXHandler* myParentHandler;

    int myParentIndicator;

    std::string myFileName;

};

#endif

/****************************************************************************/