NIXMLNodesHandler.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// Importer for network nodes stored in XML
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <utils/xml/SUMOSAXHandler.h>
#include <utils/geom/Position.h>
 
 
// ===========================================================================
// class declarations
// ===========================================================================
class OptionsCont;
class GeoConvHelper;
class NBNode;
class NBNodeCont;
class NBTrafficLightLogicCont;
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class NIXMLNodesHandler : public SUMOSAXHandler {
 
public:
    NIXMLNodesHandler(NBNodeCont& nc, NBEdgeCont& ec, NBTrafficLightLogicCont& tlc,
                      OptionsCont& options);
 
 
    ~NIXMLNodesHandler();
 
    static NBNode* processNodeType(const SUMOSAXAttributes& attrs, NBNode* node, const std::string& nodeID, const Position& position,
                                   bool updateEdgeGeometries,
                                   NBNodeCont& nc, NBEdgeCont& ec,
                                   NBTrafficLightLogicCont& tlc,
                                   GeoConvHelper* from_srs = nullptr);
 
protected:
 
 
    void myStartElement(int element,
                        const SUMOSAXAttributes& attrs);
    void myEndElement(int element);
 
 
private:
    /*
     * @brief Parses node information
     * Tries to parse a node. If the node can be parsed, it is stored within
     *  "myNodeCont". Otherwise an error is generated. Then, if given
     *  the tls information is parsed and inserted into "myTLLogicCont".
     */
    void addNode(const SUMOSAXAttributes& attrs);
 
    /*
     * @brief Parses node deletion information
     */
    void deleteNode(const SUMOSAXAttributes& attrs);
 
    /*
     * @brief Parses a cluster of nodes to be joined
     */
    void addJoinCluster(const SUMOSAXAttributes& attrs);
 
    /*
     * @brief Parses a list of nodes to be excluded from joining
     */
    void addJoinExclusion(const SUMOSAXAttributes& attrs);
 
 
    static void processTrafficLightDefinitions(const SUMOSAXAttributes& attrs,
            NBNode* currentNode, NBTrafficLightLogicCont& tlc);
 
 
private:
    OptionsCont& myOptions;
 
    std::string myID;
 
    Position myPosition;
 
    NBNodeCont& myNodeCont;
 
    NBEdgeCont& myEdgeCont;
 
    NBTrafficLightLogicCont& myTLLogicCont;
 
    GeoConvHelper* myLocation;
 
    Parameterised* myLastParameterised;
 
private:
    NIXMLNodesHandler(const NIXMLNodesHandler& s);
 
    NIXMLNodesHandler& operator=(const NIXMLNodesHandler& s);
 
};