SUMO - Simulation of Urban MObility
|
Base class for loading routes from XML-files. More...
#include <ROTypedXMLRoutesLoader.h>
Public Member Functions | |
void | characters (const XMLCh *const chars, const XERCES3_SIZE_t length) |
The inherited method called when characters occured. More... | |
void | endDocument () |
Called when the document has ended. More... | |
bool | ended () const |
Returns the information whether no routes are available from this loader anymore. 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... | |
SUMOTime | getLastReadTimeStep () const |
Returns the time the current (last read) route starts at. More... | |
virtual bool | readRoutesAtLeastUntil (SUMOTime time) |
Adds routes from the file until the given time is reached. More... | |
void | registerParent (const int tag, GenericSAXHandler *handler) |
Assigning a parent handler which is enabled when the specified tag is closed. More... | |
ROTypedXMLRoutesLoader (RONet &net, SUMOTime begin, SUMOTime end, const std::string &file="") | |
Constructor. 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... | |
virtual | ~ROTypedXMLRoutesLoader () |
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... | |
virtual void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Callback method for an opening tag to implement by derived classes. More... | |
Protected Attributes | |
SUMOTime | myBegin |
The time for which the first route shall be loaded. More... | |
SUMOTime | myCurrentDepart |
The currently read vehicle's depart. More... | |
SUMOTime | myEnd |
The time for which the first route shall be loaded. More... | |
bool | myEnded |
Information whether the whole file has been parsed. More... | |
RONet & | myNet |
The network to add routes to. More... | |
bool | myNextRouteRead |
The information whether the next route was read. More... | |
SUMOSAXReader * | myParser |
The parser used. More... | |
Private Member Functions | |
ROTypedXMLRoutesLoader & | operator= (const ROTypedXMLRoutesLoader &src) |
Invalidated assignment operator. More... | |
ROTypedXMLRoutesLoader (const ROTypedXMLRoutesLoader &src) | |
Invalidated copy constructor. More... | |
Base class for loading routes from XML-files.
Base class for loaders which load route definitions which use XML-derived formats. Some methods as the initialisation and the file processing, together with the need for a parser are common to all such loaders.
Definition at line 59 of file ROTypedXMLRoutesLoader.h.
ROTypedXMLRoutesLoader::ROTypedXMLRoutesLoader | ( | RONet & | net, |
SUMOTime | begin, | ||
SUMOTime | end, | ||
const std::string & | file = "" |
||
) |
Constructor.
[in] | vb | The vehicle builder to use |
[in] | net | The network to add vehicles to |
[in] | begin | The time step import shall start at |
[in] | end | The time step import shall stop at |
[in] | file | Name of the used input file |
ProcessError | If an error occured during initialisation of parsing the xml-file |
Definition at line 50 of file ROTypedXMLRoutesLoader.cpp.
References GenericSAXHandler::getFileName(), XMLSubSys::getSAXReader(), myParser, and SUMOSAXReader::parseFirst().
|
virtual |
|
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.
void ROTypedXMLRoutesLoader::endDocument | ( | ) |
Called when the document has ended.
Definition at line 83 of file ROTypedXMLRoutesLoader.cpp.
References myEnded.
|
inline |
Returns the information whether no routes are available from this loader anymore.
Definition at line 101 of file ROTypedXMLRoutesLoader.h.
References myEnded.
Referenced by readRoutesAtLeastUntil().
|
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(), MSRouteLoader::init(), PCNetProjectionLoader::loadIfSet(), NILoader::loadXMLType(), MSTriggeredXMLReader::myInit(), GUISettingsHandler::myStartElement(), RODFDetectorHandler::myStartElement(), RORDLoader_TripDefs::myStartElement(), SUMORouteHandler::myStartElement(), RORDLoader_SUMOBase::myStartElement(), PCLoaderXML::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), RORDGenerator_ODAmounts::RORDGenerator_ODAmounts(), ROTypedXMLRoutesLoader(), XMLSubSys::runParser(), and GenericSAXHandler::startElement().
|
inline |
Returns the time the current (last read) route starts at.
Definition at line 92 of file ROTypedXMLRoutesLoader.h.
References myCurrentDepart.
Referenced by readRoutesAtLeastUntil().
|
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::EdgesHandler, NIImporter_OpenStreetMap::NodesHandler, PCLoaderOSM::EdgesHandler, SAXWeightsHandler, MSTriggeredRerouter, PCLoaderOSM::NodesHandler, NIImporter_ITSUMO::Handler, MSLaneSpeedTrigger, NIImporter_SUMO, NLHandler, NIXMLEdgesHandler, RORDGenerator_ODAmounts, ODDistrictHandler, RORDLoader_SUMOBase, RORouteHandler, MSRouteHandler, NIXMLTrafficLightsHandler, SUMORouteHandler, and RORDLoader_TripDefs.
Definition at line 232 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement(), and SUMOSAXReader::parseNext().
|
protectedvirtualinherited |
Callback method for an opening tag to implement by derived classes.
Called by "startElement" (see there).
[in] | element | The element that contains the characters, given as a int |
[in] | attrs | The SAX-attributes, wrapped as SUMOSAXAttributes ProcessError These method may throw a ProcessError if something fails |
Reimplemented in NIImporter_OpenDrive, NIImporter_OpenStreetMap::EdgesHandler, NIImporter_OpenStreetMap::NodesHandler, PCLoaderOSM::EdgesHandler, SAXWeightsHandler, NIImporter_MATSim::EdgesHandler, MSTriggeredRerouter, PCLoaderOSM::NodesHandler, MSLaneSpeedTrigger, NIImporter_SUMO, NLHandler, NIImporter_MATSim::NodesHandler, PCNetProjectionLoader, NIImporter_ITSUMO::Handler, NIXMLEdgesHandler, PCLoaderXML, NIXMLNodesHandler, RORDGenerator_ODAmounts, RORDLoader_SUMOBase, ODDistrictHandler, ROJTRTurnDefLoader, RONetHandler, RORouteHandler, NIXMLTypesHandler, MSRouteHandler, NIXMLConnectionsHandler, NIXMLTrafficLightsHandler, PCTypeDefHandler, AGActivityGenHandler, SUMORouteHandler, RORDLoader_TripDefs, RODFDetectorHandler, and GUISettingsHandler.
Definition at line 224 of file GenericSAXHandler.cpp.
Referenced by SUMOSAXReader::parseNext(), and GenericSAXHandler::startElement().
|
private |
Invalidated assignment operator.
Adds routes from the file until the given time is reached.
[in] | time | The time until which route definitions shall be loaded |
ProcessError | If a major error occured |
Reimplemented in RORDGenerator_ODAmounts.
Definition at line 71 of file ROTypedXMLRoutesLoader.cpp.
References ended(), getLastReadTimeStep(), myEnded, myNextRouteRead, myParser, and SUMOSAXReader::parseNext().
|
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().
|
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(), NIImporter_OpenStreetMap::load(), PCNetProjectionLoader::loadIfSet(), 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.
|
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.
|
protected |
The time for which the first route shall be loaded.
Definition at line 118 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDLoader_SUMOBase::closeVehicle(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and RORDGenerator_ODAmounts::readRoutesAtLeastUntil().
|
protected |
The currently read vehicle's depart.
Definition at line 127 of file ROTypedXMLRoutesLoader.h.
Referenced by getLastReadTimeStep(), RORDLoader_TripDefs::myStartElement(), RORDLoader_SUMOBase::myStartElement(), RORDGenerator_ODAmounts::readRoutesAtLeastUntil(), and RORDGenerator_ODAmounts::RORDGenerator_ODAmounts().
|
protected |
The time for which the first route shall be loaded.
Definition at line 121 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), RORDLoader_SUMOBase::closeVehicle(), and RORDLoader_TripDefs::myEndElement().
|
protected |
Information whether the whole file has been parsed.
Definition at line 133 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), endDocument(), ended(), and readRoutesAtLeastUntil().
|
protected |
The network to add routes to.
Definition at line 115 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDGenerator_ODAmounts::buildForTimeStep(), RORDLoader_SUMOBase::closeVehicle(), RORDLoader_TripDefs::getEdge(), RORDLoader_TripDefs::myEndElement(), RORDLoader_SUMOBase::myEndElement(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and RORDLoader_SUMOBase::parseRoute().
|
protected |
The information whether the next route was read.
Definition at line 130 of file ROTypedXMLRoutesLoader.h.
Referenced by RORDLoader_TripDefs::myEndElement(), RORDLoader_SUMOBase::myEndElement(), RORDGenerator_ODAmounts::myEndFlowAmountDef(), and readRoutesAtLeastUntil().
|
protected |
The parser used.
Definition at line 124 of file ROTypedXMLRoutesLoader.h.
Referenced by readRoutesAtLeastUntil(), ROTypedXMLRoutesLoader(), and ~ROTypedXMLRoutesLoader().