SUMO - Simulation of Urban MObility
|
Importer for edge connections stored in XML. More...
#include <NIXMLConnectionsHandler.h>
Public Member Functions | |
void | characters (const XMLCh *const chars, const XERCES3_SIZE_t length) |
The inherited method called when characters occured. More... | |
void | endElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname) |
The inherited method called when a tag is being closed. More... | |
const std::string & | getFileName () const |
returns the current file name More... | |
NIXMLConnectionsHandler (NBEdgeCont &ec) | |
Constructor. More... | |
void | registerParent (const int tag, GenericSAXHandler *handler) |
Assigning a parent handler which is enabled when the specified tag is closed. More... | |
void | setFileName (const std::string &name) |
Sets the current file name. More... | |
void | startElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname, const XERCES_CPP_NAMESPACE::Attributes &attrs) |
The inherited method called when a new tag opens. More... | |
~NIXMLConnectionsHandler () | |
Destructor. More... | |
SAX ErrorHandler callbacks | |
void | warning (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-warnings. More... | |
void | error (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-errors. More... | |
void | fatalError (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Handler for XML-errors. More... | |
Protected Member Functions | |
std::string | buildErrorMessage (const XERCES_CPP_NAMESPACE::SAXParseException &exception) |
Builds an error message. More... | |
virtual void | myCharacters (int element, const std::string &chars) |
Callback method for characters to implement by derived classes. More... | |
virtual void | myEndElement (int element) |
Callback method for a closing tag to implement by derived classes. More... | |
inherited from GenericSAXHandler | |
void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Called on the opening of a tag;. More... | |
Private Member Functions | |
NIXMLConnectionsHandler (const NIXMLConnectionsHandler &s) | |
invalidated copy constructor More... | |
NIXMLConnectionsHandler & | operator= (const NIXMLConnectionsHandler &s) |
invalidated assignment operator More... | |
NBConnection | parseConnection (const std::string &defRole, const std::string &def) |
Returns the connection described by def. More... | |
bool | parseDeprecatedLaneDefinition (const SUMOSAXAttributes &attributes, NBEdge *fromEdge, NBEdge *toEdge, int *fromLane, int *toLane) |
Parses information about lane-2-lane connection in deprecated format. More... | |
void | parseLaneBound (const SUMOSAXAttributes &attrs, NBEdge *from, NBEdge *to) |
Parses a connection when it describes a lane-2-lane relationship. More... | |
bool | parseLaneDefinition (const SUMOSAXAttributes &attributes, int *fromLane, int *toLane) |
Parses information about lane-2-lane connection. More... | |
bool | parseLaneInfo (const SUMOSAXAttributes &attributes, NBEdge *fromEdge, NBEdge *toEdge, int *fromLane, int *toLane) |
Parses information about lane-2-lane connection when it describes a lane-2-lane relationship. More... | |
bool | validateLaneInfo (bool canLanesBeNegative, NBEdge *fromEdge, NBEdge *toEdge, int fromLane, int toLane) |
Validates information about lane-2-lane connection. Returns true iff information represents a valid connection for the given edges. More... | |
Private Attributes | |
NBEdgeCont & | myEdgeCont |
The edge container to fill. More... | |
MsgHandler *const | myErrorMsgHandler |
the handler for loading errors More... | |
bool | myHaveWarnedAboutDeprecatedLanes |
Information whether we have a deprecated attribute. More... | |
Importer for edge connections stored in XML.
This importer parses connections, and prohibitions, and is able to reset connections between edges.
Definition at line 57 of file NIXMLConnectionsHandler.h.
NIXMLConnectionsHandler::NIXMLConnectionsHandler | ( | NBEdgeCont & | ec | ) |
Constructor.
[in] | ec | The edge container which includes the edges to change connections of |
Definition at line 61 of file NIXMLConnectionsHandler.cpp.
NIXMLConnectionsHandler::~NIXMLConnectionsHandler | ( | ) |
Destructor.
Definition at line 69 of file NIXMLConnectionsHandler.cpp.
|
private |
invalidated copy constructor
|
protectedinherited |
Builds an error message.
The error message includes the file name and the line/column information as supported by the given SAXParseException
[in] | exception | The name of the currently processed file |
Definition at line 193 of file GenericSAXHandler.cpp.
References GenericSAXHandler::getFileName().
Referenced by GenericSAXHandler::error(), GenericSAXHandler::fatalError(), and GenericSAXHandler::warning().
|
inherited |
The inherited method called when characters occured.
The retrieved characters are converted into a string and appended into a private buffer. They are reported as soon as the element ends.
recheck/describe what happens with characters when a new element is opened
describe characters processing in the class' head
Definition at line 176 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), and GenericSAXHandler::myCharactersVector.
|
inherited |
The inherited method called when a tag is being closed.
This method calls the user-implemented methods myCharacters with the previously collected and converted characters.
Then, myEndElement is called, supplying it the qname converted to its enum- and string-representations.
recheck/describe encoding of the string-representation
do not generate and report the string-representation
Definition at line 126 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), GenericSAXHandler::convertTag(), GenericSAXHandler::myCharacters(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myEndElement(), GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, XMLSubSys::setHandler(), SUMO_TAG_INCLUDE, and SUMO_TAG_NOTHING.
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
[in] | exception | The occured exception to process |
ProcessError | On any call |
Definition at line 212 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
ProcessError | On any call |
[in] | exception | The occured exception to process |
Definition at line 218 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
|
inherited |
returns the current file name
Definition at line 86 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), NLHandler::addPOI(), NLHandler::addPoly(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), PCNetProjectionLoader::load(), NILoader::loadXMLType(), RODFDetectorHandler::myStartElement(), GUISettingsHandler::myStartElement(), MSStateHandler::myStartElement(), SUMORouteHandler::myStartElement(), PCLoaderXML::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), XMLSubSys::runParser(), GenericSAXHandler::startElement(), and SUMORouteLoader::SUMORouteLoader().
|
protectedvirtualinherited |
Callback method for characters to implement by derived classes.
Called by "endElement" (see there).
[in] | element | The opened element, given as a int |
[in] | chars | The complete embedded character string ProcessError These method may throw a ProcessError if something fails |
Reimplemented in NIImporter_ITSUMO::Handler.
Definition at line 228 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement().
|
protectedvirtualinherited |
Callback method for a closing tag to implement by derived classes.
Called by "endElement" (see there).
[in] | element | The closed element, given as a int ProcessError These method may throw a ProcessError if something fails |
Reimplemented in NIImporter_OpenDrive, NIImporter_OpenStreetMap::RelationHandler, NIImporter_OpenStreetMap::EdgesHandler, NIImporter_OpenStreetMap::NodesHandler, PCLoaderOSM::EdgesHandler, SAXWeightsHandler, MSTriggeredRerouter, PCLoaderOSM::NodesHandler, NIImporter_ITSUMO::Handler, MSLaneSpeedTrigger, NLHandler, NIImporter_SUMO, NIXMLEdgesHandler, ODDistrictHandler, RORouteHandler, SUMORouteHandler, MSStateHandler, MSCalibrator, MSRouteHandler, and NIXMLTrafficLightsHandler.
Definition at line 232 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement(), and SUMOSAXReader::parseNext().
|
protectedvirtual |
Called on the opening of a tag;.
[in] | element | ID of the currently opened element |
[in] | attrs | Attributes within the currently opened element |
ProcessError | If something fails |
Reimplemented from GenericSAXHandler.
Definition at line 73 of file NIXMLConnectionsHandler.cpp.
References NBEdge::addEdge2EdgeConnection(), NBNode::addSortedLinkFoes(), NBEdge::EDGE2EDGES, SUMOSAXAttributes::get(), NBConnection::getFrom(), Named::getID(), SUMOSAXAttributes::getOpt(), NBEdge::getStep(), NBEdge::getToNode(), SUMOSAXAttributes::hasAttribute(), NBEdge::hasConnectionTo(), MsgHandler::inform(), NBEdge::isConnectedTo(), NBEdge::LANES2EDGES, myEdgeCont, myErrorMsgHandler, parseConnection(), parseLaneBound(), parseLaneInfo(), NBEdge::removeFromConnections(), NBEdgeCont::retrieve(), SUMO_ATTR_FROM, SUMO_ATTR_FROM_LANE, SUMO_ATTR_LANE, SUMO_ATTR_PROHIBITED, SUMO_ATTR_PROHIBITOR, SUMO_ATTR_TO, SUMO_ATTR_TO_LANE, SUMO_TAG_CONNECTION, SUMO_TAG_DELETE, SUMO_TAG_PROHIBITION, toString(), NBEdgeCont::wasIgnored(), NBEdgeCont::wasRemoved(), and WRITE_WARNING.
|
private |
invalidated assignment operator
|
private |
Returns the connection described by def.
def should have the following format <FROM_EDGE_ID>[_<FROM_LANE_NO>]-><TO_EDGE_ID>[_<TO_LANE_NO>].
[in] | defRole | "prohibitor" or "prohibited" - used for error reporting |
[in] | def | The definition of the connection |
Definition at line 163 of file NIXMLConnectionsHandler.cpp.
References MsgHandler::inform(), myEdgeCont, myErrorMsgHandler, and NBEdgeCont::retrieve().
Referenced by myStartElement().
|
inlineprivate |
Parses information about lane-2-lane connection in deprecated format.
[in] | attrs | The attributes to get further information about the connection from |
[in] | fromEdge | The edge at which the connection starts (the on incoming into a node) |
[in] | toEdge | The edge at which the connection ends (the on outgoing from a node) |
[out] | fromLane | The lane at which connection starts |
[out] | toLane | The lane at which connection ends |
Definition at line 270 of file NIXMLConnectionsHandler.cpp.
References TplConvert::_2intSec(), SUMOSAXAttributes::get(), Named::getID(), MsgHandler::inform(), myErrorMsgHandler, myHaveWarnedAboutDeprecatedLanes, SUMO_ATTR_FROM_LANE, SUMO_ATTR_LANE, SUMO_ATTR_TO_LANE, toString(), and WRITE_WARNING.
Referenced by parseLaneInfo().
|
private |
Parses a connection when it describes a lane-2-lane relationship.
[in] | attrs | The attributes to get further information about the connection from |
[in] | from | The edge at which the connection starts (the on incoming into a node) |
[in] | to | The edge at which the connection ends (the on outgoing from a node) |
Definition at line 198 of file NIXMLConnectionsHandler.cpp.
References NBEdge::addLane2LaneConnection(), NBEdgeCont::addPostProcessConnection(), NBEdge::disableConnection4TLS(), OptionsCont::getBool(), Named::getID(), NBEdge::getLaneID(), SUMOSAXAttributes::getOpt(), OptionsCont::getOptions(), NBNode::getOutgoingEdges(), NBEdge::getToNode(), NBEdge::hasConnectionTo(), MsgHandler::inform(), NBEdge::L2L_USER, myEdgeCont, myErrorMsgHandler, parseLaneInfo(), SUMO_ATTR_PASS, SUMO_ATTR_UNCONTROLLED, validateLaneInfo(), and WRITE_WARNING.
Referenced by myStartElement().
|
inlineprivate |
Parses information about lane-2-lane connection.
[in] | attrs | The attributes to get further information about the connection from |
[out] | fromLane | The lane at which connection starts |
[out] | toLane | The lane at which connection ends |
Definition at line 297 of file NIXMLConnectionsHandler.cpp.
References SUMOSAXAttributes::get(), SUMO_ATTR_FROM_LANE, and SUMO_ATTR_TO_LANE.
Referenced by parseLaneInfo().
|
private |
Parses information about lane-2-lane connection when it describes a lane-2-lane relationship.
[in] | attrs | The attributes to get further information about the connection from |
[in] | fromEdge | The edge at which the connection starts (the on incoming into a node) |
[in] | toEdge | The edge at which the connection ends (the on outgoing from a node) |
[out] | fromLane | The lane at which connection starts |
[out] | toLane | The lane at which connection ends |
Definition at line 259 of file NIXMLConnectionsHandler.cpp.
References SUMOSAXAttributes::hasAttribute(), parseDeprecatedLaneDefinition(), parseLaneDefinition(), and SUMO_ATTR_LANE.
Referenced by myStartElement(), and parseLaneBound().
|
inherited |
Assigning a parent handler which is enabled when the specified tag is closed.
Definition at line 168 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, and XMLSubSys::setHandler().
Referenced by NLTriggerBuilder::parseAndBuildCalibrator(), NLTriggerBuilder::parseAndBuildLaneSpeedTrigger(), and NLTriggerBuilder::parseAndBuildRerouter().
|
inherited |
Sets the current file name.
[in] | name | The name of the currently processed file |
Definition at line 80 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NIImporter_SUMO::_loadNetwork(), GUISettingsHandler::GUISettingsHandler(), PCNetProjectionLoader::load(), NIImporter_OpenStreetMap::load(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), and XMLSubSys::runParser().
|
inherited |
The inherited method called when a new tag opens.
The method parses the supplied XMLCh*-qname using the internal name/enum-map to obtain the enum representation of the attribute name.
Then, "myStartElement" is called supplying the enumeration value, the string-representation of the name and the attributes.
recheck/describe encoding of the string-representation
do not generate and report the string-representation
Definition at line 105 of file GenericSAXHandler.cpp.
References TplConvert::_2str(), GenericSAXHandler::convertTag(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), SUMOSAXAttributesImpl_Xerces::getString(), FileHelpers::isAbsolute(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myPredefinedTags, GenericSAXHandler::myPredefinedTagsMML, GenericSAXHandler::myStartElement(), XMLSubSys::runParser(), SUMO_ATTR_HREF, and SUMO_TAG_INCLUDE.
|
private |
Validates information about lane-2-lane connection. Returns true iff information represents a valid connection for the given edges.
[in] | canLanesBeNegative | Whether negative lane indices are allowed (used when specifying resets) |
[in] | fromEdge | The originating edge |
[in] | toEdge | The target edge |
[in] | fromLane | The originating lane index |
[in] | toLane | The target lane index |
Definition at line 308 of file NIXMLConnectionsHandler.cpp.
References Named::getID(), NBEdge::getNumLanes(), MsgHandler::inform(), myErrorMsgHandler, SUMO_ATTR_FROM_LANE, SUMO_ATTR_TO_LANE, and toString().
Referenced by parseLaneBound().
|
inherited |
Handler for XML-warnings.
The message is built using buildErrorMessage and reported to the warning-instance of the MsgHandler.
[in] | exception | The occured exception to process |
Definition at line 206 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage(), and WRITE_WARNING.
|
private |
The edge container to fill.
Definition at line 146 of file NIXMLConnectionsHandler.h.
Referenced by myStartElement(), parseConnection(), and parseLaneBound().
|
private |
the handler for loading errors
Definition at line 152 of file NIXMLConnectionsHandler.h.
Referenced by myStartElement(), parseConnection(), parseDeprecatedLaneDefinition(), parseLaneBound(), and validateLaneInfo().
|
private |
Information whether we have a deprecated attribute.
Definition at line 149 of file NIXMLConnectionsHandler.h.
Referenced by parseDeprecatedLaneDefinition().