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 2001-2010 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 "SUMOXMLDefinitions.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:
    struct Attr {
        const char *name;
        SumoXMLAttr key;
    };

    struct Tag {
        const char *name;
        SumoXMLTag key;
    };


public:
    GenericSAXHandler(Tag *tags, Attr *attrs, const std::string &file) throw();


    virtual ~GenericSAXHandler() throw();


    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 SumoXMLTag tag, GenericSAXHandler* handler);


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


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


protected:
    virtual void myStartElement(SumoXMLTag element,
                                const SUMOSAXAttributes &attrs) throw(ProcessError);


    virtual void myCharacters(SumoXMLTag element,
                              const std::string &chars) throw(ProcessError);


    virtual void myEndElement(SumoXMLTag element) throw(ProcessError);


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


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


private:


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

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

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




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

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

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

    std::string myFileName;

    GenericSAXHandler* myParentHandler;
    SumoXMLTag myParentIndicator;


};


// ===========================================================================
// declarations
// ===========================================================================

extern GenericSAXHandler::Tag sumotags[];

extern GenericSAXHandler::Attr sumoattrs[];


#endif

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