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. | |
void | endElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname) |
The inherited method called when a tag is being closed. | |
const std::string & | getFileName () const |
returns the current file name | |
NIXMLConnectionsHandler (NBEdgeCont &ec) | |
Constructor. | |
void | registerParent (const int tag, GenericSAXHandler *handler) |
Assigning a parent handler which is enabled when the specified tag is closed. | |
void | setFileName (const std::string &name) |
Sets the current file name. | |
void | startElement (const XMLCh *const uri, const XMLCh *const localname, const XMLCh *const qname, const Attributes &attrs) |
The inherited method called when a new tag opens. | |
~NIXMLConnectionsHandler () | |
Destructor. | |
SAX ErrorHandler callbacks | |
void | warning (const SAXParseException &exception) |
Handler for XML-warnings. | |
void | error (const SAXParseException &exception) |
Handler for XML-errors. | |
void | fatalError (const SAXParseException &exception) |
Handler for XML-errors. | |
Protected Member Functions | |
std::string | buildErrorMessage (const SAXParseException &exception) |
Builds an error message. | |
virtual void | myCharacters (int element, const std::string &chars) |
Callback method for characters to implement by derived classes. | |
virtual void | myEndElement (int element) |
Callback method for a closing tag to implement by derived classes. | |
inherited from GenericSAXHandler | |
void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Called on the opening of a tag;. | |
Private Member Functions | |
NIXMLConnectionsHandler (const NIXMLConnectionsHandler &s) | |
invalidated copy constructor | |
NIXMLConnectionsHandler & | operator= (const NIXMLConnectionsHandler &s) |
invalidated assignment operator | |
NBConnection | parseConnection (const std::string &defRole, const std::string &def) |
Returns the connection described by def. | |
bool | parseDeprecatedLaneDefinition (const SUMOSAXAttributes &attributes, NBEdge *fromEdge, NBEdge *toEdge, int *fromLane, int *toLane) |
Parses information about lane-2-lane connection in deprecated format. | |
void | parseLaneBound (const SUMOSAXAttributes &attrs, NBEdge *from, NBEdge *to) |
Parses a connection when it describes a lane-2-lane relationship. | |
bool | parseLaneDefinition (const SUMOSAXAttributes &attributes, int *fromLane, int *toLane) |
Parses information about lane-2-lane connection. | |
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. | |
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. | |
Private Attributes | |
NBEdgeCont & | myEdgeCont |
The edge container to fill. | |
MsgHandler *const | myErrorMsgHandler |
the handler for loading errors | |
bool | myHaveWarnedAboutDeprecatedLanes |
Information whether we have a deprecated attribute. |
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.
Constructor.
[in] | ec | The edge container which includes the edges to change connections of |
Definition at line 62 of file NIXMLConnectionsHandler.cpp.
Destructor.
Definition at line 70 of file NIXMLConnectionsHandler.cpp.
NIXMLConnectionsHandler::NIXMLConnectionsHandler | ( | const NIXMLConnectionsHandler & | s | ) | [private] |
invalidated copy constructor
std::string GenericSAXHandler::buildErrorMessage | ( | const SAXParseException & | exception | ) | [protected, inherited] |
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().
void GenericSAXHandler::characters | ( | const XMLCh *const | chars, |
const XERCES3_SIZE_t | length | ||
) | [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 GenericSAXHandler::myCharactersVector.
void GenericSAXHandler::endElement | ( | const XMLCh *const | uri, |
const XMLCh *const | localname, | ||
const XMLCh *const | qname | ||
) | [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 GenericSAXHandler::convertTag(), GenericSAXHandler::myCharacters(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myEndElement(), GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, XMLSubSys::setHandler(), SUMO_TAG_INCLUDE, and SUMO_TAG_NOTHING.
void GenericSAXHandler::error | ( | const SAXParseException & | exception | ) | [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().
Referenced by NLHandler::getLanesFromIndices().
void GenericSAXHandler::fatalError | ( | const SAXParseException & | exception | ) | [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().
const std::string & GenericSAXHandler::getFileName | ( | ) | const [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::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), MSRouteLoader::init(), PCNetProjectionLoader::loadIfSet(), NILoader::loadXMLType(), MSTriggeredXMLReader::myInit(), GUISettingsHandler::myStartElement(), RODFDetectorHandler::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), RORDGenerator_ODAmounts::RORDGenerator_ODAmounts(), ROTypedXMLRoutesLoader::ROTypedXMLRoutesLoader(), XMLSubSys::runParser(), and GenericSAXHandler::startElement().
void GenericSAXHandler::myCharacters | ( | int | element, |
const std::string & | chars | ||
) | [protected, virtual, inherited] |
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_OpenDrive, NIImporter_SUMO, PCNetProjectionLoader, NIImporter_ITSUMO::Handler, PCLoaderXML, RORDLoader_SUMOBase, and ROJTRTurnDefLoader.
Definition at line 228 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement().
void GenericSAXHandler::myEndElement | ( | int | element | ) | [protected, virtual, inherited] |
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::EdgesHandler, NIImporter_OpenStreetMap::NodesHandler, PCLoaderOSM::EdgesHandler, SAXWeightsHandler, MSTriggeredRerouter, PCLoaderOSM::NodesHandler, NIImporter_SUMO, NIImporter_ITSUMO::Handler, MSLaneSpeedTrigger, NLHandler, RORDLoader_SUMOBase, NIXMLEdgesHandler, ODDistrictHandler, RORDGenerator_ODAmounts, MSRouteHandler, NIXMLTrafficLightsHandler, SUMORouteHandler, and RORDLoader_TripDefs.
Definition at line 232 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement().
void NIXMLConnectionsHandler::myStartElement | ( | int | element, |
const SUMOSAXAttributes & | attrs | ||
) | [protected, virtual] |
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 74 of file NIXMLConnectionsHandler.cpp.
References NBEdge::addEdge2EdgeConnection(), NBNode::addSortedLinkFoes(), NBConnection::getFrom(), Named::getID(), SUMOSAXAttributes::getOptStringReporting(), SUMOSAXAttributes::getStringReporting(), NBEdge::getToNode(), SUMOSAXAttributes::hasAttribute(), NBEdge::hasConnectionTo(), MsgHandler::inform(), NBEdge::isConnectedTo(), 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.
NIXMLConnectionsHandler& NIXMLConnectionsHandler::operator= | ( | const NIXMLConnectionsHandler & | s | ) | [private] |
invalidated assignment operator
NBConnection NIXMLConnectionsHandler::parseConnection | ( | const std::string & | defRole, |
const std::string & | def | ||
) | [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 164 of file NIXMLConnectionsHandler.cpp.
References MsgHandler::inform(), myEdgeCont, myErrorMsgHandler, and NBEdgeCont::retrieve().
Referenced by myStartElement().
bool NIXMLConnectionsHandler::parseDeprecatedLaneDefinition | ( | const SUMOSAXAttributes & | attributes, |
NBEdge * | fromEdge, | ||
NBEdge * | toEdge, | ||
int * | fromLane, | ||
int * | toLane | ||
) | [inline, private] |
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 268 of file NIXMLConnectionsHandler.cpp.
References Named::getID(), SUMOSAXAttributes::getStringReporting(), MsgHandler::inform(), myErrorMsgHandler, myHaveWarnedAboutDeprecatedLanes, StringTokenizer::next(), StringTokenizer::size(), SUMO_ATTR_FROM_LANE, SUMO_ATTR_LANE, SUMO_ATTR_TO_LANE, toString(), and WRITE_WARNING.
Referenced by parseLaneInfo().
void NIXMLConnectionsHandler::parseLaneBound | ( | const SUMOSAXAttributes & | attrs, |
NBEdge * | from, | ||
NBEdge * | to | ||
) | [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 199 of file NIXMLConnectionsHandler.cpp.
References NBEdge::addLane2LaneConnection(), NBEdge::disableConnection4TLS(), Named::getID(), NBEdge::getLaneID(), SUMOSAXAttributes::getOptBoolReporting(), NBNode::getOutgoingEdges(), NBEdge::getToNode(), NBEdge::hasConnectionTo(), MsgHandler::inform(), NBEdge::L2L_USER, myErrorMsgHandler, parseLaneInfo(), SUMO_ATTR_PASS, SUMO_ATTR_UNCONTROLLED, validateLaneInfo(), and WRITE_WARNING.
Referenced by myStartElement().
bool NIXMLConnectionsHandler::parseLaneDefinition | ( | const SUMOSAXAttributes & | attributes, |
int * | fromLane, | ||
int * | toLane | ||
) | [inline, private] |
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 295 of file NIXMLConnectionsHandler.cpp.
References SUMOSAXAttributes::getIntReporting(), SUMO_ATTR_FROM_LANE, and SUMO_ATTR_TO_LANE.
Referenced by parseLaneInfo().
bool NIXMLConnectionsHandler::parseLaneInfo | ( | const SUMOSAXAttributes & | attributes, |
NBEdge * | fromEdge, | ||
NBEdge * | toEdge, | ||
int * | fromLane, | ||
int * | toLane | ||
) | [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 257 of file NIXMLConnectionsHandler.cpp.
References SUMOSAXAttributes::hasAttribute(), parseDeprecatedLaneDefinition(), parseLaneDefinition(), and SUMO_ATTR_LANE.
Referenced by myStartElement(), and parseLaneBound().
void GenericSAXHandler::registerParent | ( | const int | tag, |
GenericSAXHandler * | handler | ||
) | [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::parseAndBuildLaneSpeedTrigger(), and NLTriggerBuilder::parseAndBuildRerouter().
void GenericSAXHandler::setFileName | ( | const std::string & | name | ) | [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(), AGActivityGen::importInfoCity(), NIImporter_OpenStreetMap::load(), PCNetProjectionLoader::loadIfSet(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NIImporter_OpenDrive::loadNetwork(), NILoader::loadXMLType(), and XMLSubSys::runParser().
void GenericSAXHandler::startElement | ( | const XMLCh *const | uri, |
const XMLCh *const | localname, | ||
const XMLCh *const | qname, | ||
const Attributes & | attrs | ||
) | [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 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.
bool NIXMLConnectionsHandler::validateLaneInfo | ( | bool | canLanesBeNegative, |
NBEdge * | fromEdge, | ||
NBEdge * | toEdge, | ||
int | fromLane, | ||
int | toLane | ||
) | [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 306 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().
void GenericSAXHandler::warning | ( | const SAXParseException & | exception | ) | [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.
NBEdgeCont& NIXMLConnectionsHandler::myEdgeCont [private] |
The edge container to fill.
Definition at line 146 of file NIXMLConnectionsHandler.h.
Referenced by myStartElement(), and parseConnection().
MsgHandler* const NIXMLConnectionsHandler::myErrorMsgHandler [private] |
the handler for loading errors
Definition at line 152 of file NIXMLConnectionsHandler.h.
Referenced by myStartElement(), parseConnection(), parseDeprecatedLaneDefinition(), parseLaneBound(), and validateLaneInfo().
Information whether we have a deprecated attribute.
Definition at line 149 of file NIXMLConnectionsHandler.h.
Referenced by parseDeprecatedLaneDefinition().