![]() |
Eclipse SUMO - Simulation of Urban MObility
|
The XML-Handler for network loading. More...
#include <ShapeHandler.h>
Public Member Functions | |
void | characters (const XMLCh *const chars, const XERCES3_SIZE_t length) |
The inherited method called when characters occurred. 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... | |
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... | |
ShapeHandler (const std::string &file, ShapeContainer &sc, const GeoConvHelper *=nullptr) | |
Constructor. 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 | ~ShapeHandler () |
Destructor. More... | |
Static Public Member Functions | |
static bool | loadFiles (const std::vector< std::string > &files, ShapeHandler &sh) |
loads all of the given files More... | |
inherited from GenericSAXHandler | |
ShapeContainer & | myShapeContainer |
reference to shape container in which all Shares are being added More... | |
std::string | myPrefix |
The prefix to use. More... | |
RGBColor | myDefaultColor |
The default color to use. More... | |
double | myDefaultLayer |
The default layer to use. More... | |
bool | myDefaultFill |
Information whether polygons should be filled. More... | |
Parameterised * | myLastParameterised |
element to receive parameters More... | |
const GeoConvHelper * | myGeoConvHelper |
geo-conversion to use during loading More... | |
virtual void | myStartElement (int element, const SUMOSAXAttributes &attrs) |
Called on the opening of a tag;. More... | |
virtual void | myEndElement (int element) |
Called when a closing tag occurs. More... | |
virtual Position | getLanePos (const std::string &poiID, const std::string &laneID, double lanePos, double lanePosLat)=0 |
get position for a given laneID (Has to be implemented in all child) More... | |
virtual bool | addLanePosParams () |
Whether some input attributes shall be automatically added as params (Can be implemented in all child) More... | |
void | setDefaults (const std::string &prefix, const RGBColor &color, const double layer, const bool fill=false) |
set default values More... | |
void | addPOI (const SUMOSAXAttributes &attrs, const bool ignorePruning, const bool useProcessing) |
adds a POI More... | |
void | addPoly (const SUMOSAXAttributes &attrs, const bool ignorePruning, const bool useProcessing) |
adds a polygon More... | |
Parameterised * | getLastParameterised () const |
get last parameterised object More... | |
ShapeHandler (const ShapeHandler &s)=delete | |
invalidate copy constructor More... | |
ShapeHandler & | operator= (const ShapeHandler &s)=delete |
invalidate assignment operator 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... | |
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... | |
void | setSchemaSeen (const bool schemaSeen=true) |
XMLCh * | convert (const std::string &name) const |
converts from c++-string into unicode More... | |
int | convertTag (const std::string &tag) const |
Converts a tag from its string into its numerical representation. More... | |
attributes parsing | |
typedef std::map< int, XMLCh * > | AttrMap |
AttrMap | myPredefinedTags |
std::map< int, std::string > | myPredefinedTagsMML |
the map from ids to their string representation More... | |
elements parsing | |
typedef std::map< std::string, int > | TagMap |
TagMap | myTagMap |
std::vector< std::string > | myCharactersVector |
A list of character strings obtained so far to build the complete characters string at the end. More... | |
GenericSAXHandler * | myParentHandler |
The handler to give control back to. More... | |
int | myParentIndicator |
The tag indicating that control should be given back. More... | |
std::string | myFileName |
The name of the currently parsed file. More... | |
std::string | myExpectedRoot |
The root element to expect, empty string disables the check. More... | |
bool | mySchemaSeen |
whether the reader has already seen a schema More... | |
The XML-Handler for network loading.
The SAX2-handler responsible for parsing networks and routes to load. This is an extension of the MSRouteHandler as routes and vehicles may also be loaded from network descriptions.
Definition at line 50 of file ShapeHandler.h.
|
privateinherited |
Definition at line 286 of file GenericSAXHandler.h.
|
privateinherited |
Definition at line 300 of file GenericSAXHandler.h.
ShapeHandler::ShapeHandler | ( | const std::string & | file, |
ShapeContainer & | sc, | ||
const GeoConvHelper * | geoConvHelper = nullptr |
||
) |
Constructor.
[in] | file | Name of the parsed file |
[in,out] | net | The network to fill |
[in] | detBuilder | The detector builder to use |
[in] | triggerBuilder | The trigger builder to use |
[in] | edgeBuilder | The builder of edges to use |
[in] | junctionBuilder | The builder of junctions to use |
Definition at line 45 of file ShapeHandler.cpp.
|
virtual |
Destructor.
Definition at line 57 of file ShapeHandler.cpp.
|
protecteddelete |
invalidate copy constructor
|
protectedvirtual |
Whether some input attributes shall be automatically added as params (Can be implemented in all child)
Reimplemented in NLShapeHandler, and NIXMLShapeHandler.
Definition at line 274 of file ShapeHandler.cpp.
Referenced by addPOI().
|
protected |
adds a POI
Definition at line 113 of file ShapeHandler.cpp.
References addLanePosParams(), ShapeContainer::addPOI(), Shape::DEFAULT_ANGLE, Shape::DEFAULT_IMG_FILE, Shape::DEFAULT_IMG_HEIGHT, Shape::DEFAULT_IMG_WIDTH, Shape::DEFAULT_RELATIVEPATH, SUMOSAXAttributes::get(), NamedObjectCont< T >::get(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), GeoConvHelper::getFinal(), getLanePos(), SUMOSAXAttributes::getOpt(), ShapeContainer::getPOIs(), GeoConvHelper::getProcessing(), SUMOSAXAttributes::hasAttribute(), INVALID_POSITION, FileHelpers::isAbsolute(), myDefaultColor, myDefaultLayer, myGeoConvHelper, myLastParameterised, myPrefix, myShapeContainer, Position::set(), Parameterised::setParameter(), SUMO_ATTR_ANGLE, SUMO_ATTR_COLOR, SUMO_ATTR_HEIGHT, SUMO_ATTR_ID, SUMO_ATTR_IMGFILE, SUMO_ATTR_LANE, SUMO_ATTR_LAT, SUMO_ATTR_LAYER, SUMO_ATTR_LON, SUMO_ATTR_POSITION, SUMO_ATTR_POSITION_LAT, SUMO_ATTR_RELATIVEPATH, SUMO_ATTR_TYPE, SUMO_ATTR_WIDTH, SUMO_ATTR_X, SUMO_ATTR_Y, toString(), GeoConvHelper::usingGeoProjection(), WRITE_ERROR, GeoConvHelper::x2cartesian(), and GeoConvHelper::x2cartesian_const().
Referenced by myStartElement(), and PCLoaderXML::myStartElement().
|
protected |
adds a polygon
Definition at line 192 of file ShapeHandler.cpp.
References ShapeContainer::addPolygon(), Shape::DEFAULT_ANGLE, Shape::DEFAULT_IMG_FILE, Shape::DEFAULT_LINEWIDTH, Shape::DEFAULT_RELATIVEPATH, Shape::DEFAULT_TYPE, SUMOSAXAttributes::get(), NamedObjectCont< T >::get(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), GeoConvHelper::getFinal(), SUMOSAXAttributes::getOpt(), ShapeContainer::getPolygons(), GeoConvHelper::getProcessing(), SUMOSAXAttributes::hasAttribute(), FileHelpers::isAbsolute(), myDefaultColor, myDefaultFill, myDefaultLayer, myGeoConvHelper, myLastParameterised, myPrefix, myShapeContainer, SUMO_ATTR_ANGLE, SUMO_ATTR_COLOR, SUMO_ATTR_FILL, SUMO_ATTR_GEO, SUMO_ATTR_ID, SUMO_ATTR_IMGFILE, SUMO_ATTR_LAYER, SUMO_ATTR_LINEWIDTH, SUMO_ATTR_RELATIVEPATH, SUMO_ATTR_SHAPE, SUMO_ATTR_TYPE, WRITE_ERROR, WRITE_WARNING, GeoConvHelper::x2cartesian(), and GeoConvHelper::x2cartesian_const().
Referenced by myStartElement(), and PCLoaderXML::myStartElement().
|
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 187 of file GenericSAXHandler.cpp.
References GenericSAXHandler::getFileName(), and transcode().
Referenced by GenericSAXHandler::error(), GenericSAXHandler::fatalError(), and GenericSAXHandler::warning().
|
inherited |
The inherited method called when characters occurred.
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 170 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myCharactersVector, and StringUtils::transcode().
|
privateinherited |
converts from c++-string into unicode
[in] | name | The string to convert |
Definition at line 81 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::GenericSAXHandler().
|
privateinherited |
Converts a tag from its string into its numerical representation.
Returns the enum-representation stored for the given tag. If the tag is not known, SUMO_TAG_NOTHING is returned.
[in] | tag | The string to convert |
Definition at line 177 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myTagMap, and SUMO_TAG_NOTHING.
Referenced by GenericSAXHandler::endElement(), and GenericSAXHandler::startElement().
|
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 121 of file GenericSAXHandler.cpp.
References GenericSAXHandler::convertTag(), GenericSAXHandler::myCharacters(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myEndElement(), GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, XMLSubSys::setHandler(), SUMO_TAG_INCLUDE, SUMO_TAG_NOTHING, and StringUtils::transcode().
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
[in] | exception | The occurred exception to process |
ProcessError | On any call |
Definition at line 206 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
Referenced by MSRouteHandler::addFlowPerson(), MSRouteHandler::closeContainer(), MSRouteHandler::closePerson(), MSRouteHandler::closePersonFlow(), NIImporter_OpenDrive::geomFromSpiral(), and MSRouteHandler::myStartElement().
|
inherited |
Handler for XML-errors.
The message is built using buildErrorMessage and thrown within a ProcessError.
ProcessError | On any call |
[in] | exception | The occurred exception to process |
Definition at line 212 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage().
|
inherited |
returns the current file name
Definition at line 75 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), addPOI(), addPoly(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), GenericSAXHandler::buildErrorMessage(), PCNetProjectionLoader::load(), NILoader::loadXMLType(), NLHandler::myEndElement(), RODFDetectorHandler::myStartElement(), GUISettingsHandler::myStartElement(), SUMORouteHandler::myStartElement(), NLHandler::myStartElement(), NIImporter_OpenDrive::myStartElement(), GNEAdditionalHandler::parseAndBuildPOI(), GNEAdditionalHandler::parseAndBuildPoly(), XMLSubSys::runParser(), GenericSAXHandler::startElement(), and SUMORouteLoader::SUMORouteLoader().
|
protectedpure virtual |
get position for a given laneID (Has to be implemented in all child)
Implemented in GNEAdditionalHandler, PCLoaderXML, NLShapeHandler, and NIXMLShapeHandler.
Referenced by addPOI().
|
protected |
get last parameterised object
Definition at line 247 of file ShapeHandler.cpp.
References myLastParameterised.
Referenced by GNEAdditionalHandler::parseGenericParameter().
|
static |
loads all of the given files
Definition at line 253 of file ShapeHandler.cpp.
References XMLSubSys::runParser(), and WRITE_MESSAGE.
Referenced by NLBuilder::build().
|
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 @exceptions ProcessError These method may throw a ProcessError if something fails |
Reimplemented in NIImporter_OpenDrive, and NIImporter_ITSUMO::Handler.
Definition at line 222 of file GenericSAXHandler.cpp.
Referenced by GenericSAXHandler::endElement().
|
protectedvirtual |
Called when a closing tag occurs.
[in] | element | ID of the currently opened element |
ProcessError | If something fails |
Reimplemented from GenericSAXHandler.
Reimplemented in GNEAdditionalHandler.
Definition at line 105 of file ShapeHandler.cpp.
References myLastParameterised, and SUMO_TAG_PARAM.
Referenced by GNEAdditionalHandler::myEndElement().
|
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.
Reimplemented in PCLoaderXML, and GNEAdditionalHandler.
Definition at line 61 of file ShapeHandler.cpp.
References addPOI(), addPoly(), Shape::DEFAULT_LAYER, Shape::DEFAULT_LAYER_POI, SUMOSAXAttributes::get(), SUMOSAXAttributes::getString(), SUMOSAXAttributes::hasAttribute(), SUMOXMLDefinitions::isValidGenericParameterKey(), SUMOXMLDefinitions::isValidGenericParameterValue(), myDefaultLayer, myLastParameterised, Parameterised::setParameter(), SUMO_ATTR_KEY, SUMO_ATTR_VALUE, SUMO_TAG_PARAM, SUMO_TAG_POI, SUMO_TAG_POLY, WRITE_DEBUG, WRITE_ERROR, and WRITE_WARNING.
|
protecteddelete |
invalidate assignment operator
|
inherited |
Assigning a parent handler which is enabled when the specified tag is closed.
Definition at line 162 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myParentHandler, GenericSAXHandler::myParentIndicator, and XMLSubSys::setHandler().
Referenced by NLTriggerBuilder::parseAndBuildCalibrator(), NLTriggerBuilder::parseAndBuildLaneSpeedTrigger(), and NLTriggerBuilder::parseAndBuildRerouter().
|
protected |
set default values
Definition at line 265 of file ShapeHandler.cpp.
References myDefaultColor, myDefaultFill, myDefaultLayer, and myPrefix.
Referenced by GNEAdditionalHandler::GNEAdditionalHandler(), and PCLoaderXML::myStartElement().
|
inherited |
Sets the current file name.
[in] | name | The name of the currently processed file |
Definition at line 69 of file GenericSAXHandler.cpp.
References GenericSAXHandler::myFileName.
Referenced by NIImporter_SUMO::_loadNetwork(), GUISettingsHandler::GUISettingsHandler(), PCNetProjectionLoader::load(), NIImporter_OpenStreetMap::load(), NIImporter_Vissim::load(), loadNet(), ROLoader::loadNet(), NIImporter_ITSUMO::loadNetwork(), NIImporter_MATSim::loadNetwork(), NILoader::loadXMLType(), main(), and XMLSubSys::runParser().
|
inlineprotectedinherited |
Definition at line 255 of file GenericSAXHandler.h.
References GenericSAXHandler::mySchemaSeen.
Referenced by SUMOSAXReader::LocalSchemaResolver::resolveEntity().
|
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 94 of file GenericSAXHandler.cpp.
References GenericSAXHandler::convertTag(), FileHelpers::getConfigurationRelative(), GenericSAXHandler::getFileName(), SUMOSAXAttributesImpl_Xerces::getString(), FileHelpers::isAbsolute(), GenericSAXHandler::myCharactersVector, GenericSAXHandler::myExpectedRoot, GenericSAXHandler::myPredefinedTags, GenericSAXHandler::myPredefinedTagsMML, GenericSAXHandler::mySchemaSeen, GenericSAXHandler::myStartElement(), XMLSubSys::runParser(), SUMO_ATTR_HREF, SUMO_TAG_INCLUDE, and StringUtils::transcode().
|
inherited |
Handler for XML-warnings.
The message is built using buildErrorMessage and reported to the warning-instance of the MsgHandler.
[in] | exception | The occurred exception to process |
Definition at line 200 of file GenericSAXHandler.cpp.
References GenericSAXHandler::buildErrorMessage(), and WRITE_WARNING.
|
privateinherited |
A list of character strings obtained so far to build the complete characters string at the end.
Definition at line 307 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::characters(), GenericSAXHandler::endElement(), and GenericSAXHandler::startElement().
|
protected |
The default color to use.
Definition at line 118 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), and setDefaults().
|
protected |
Information whether polygons should be filled.
Definition at line 124 of file ShapeHandler.h.
Referenced by addPoly(), and setDefaults().
|
protected |
The default layer to use.
Definition at line 121 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), myStartElement(), and setDefaults().
|
privateinherited |
The root element to expect, empty string disables the check.
Definition at line 319 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::startElement().
|
privateinherited |
The name of the currently parsed file.
Definition at line 316 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::getFileName(), and GenericSAXHandler::setFileName().
|
protected |
geo-conversion to use during loading
Definition at line 130 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), and GNEAdditionalHandler::parseAndBuildPoly().
|
protected |
element to receive parameters
Definition at line 127 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), getLastParameterised(), myEndElement(), myStartElement(), GNEAdditionalHandler::parseAndBuildPOI(), and GNEAdditionalHandler::parseAndBuildPoly().
|
privateinherited |
The handler to give control back to.
Definition at line 310 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::endElement(), and GenericSAXHandler::registerParent().
|
privateinherited |
The tag indicating that control should be given back.
Definition at line 313 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::endElement(), and GenericSAXHandler::registerParent().
|
privateinherited |
Definition at line 289 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::GenericSAXHandler(), GenericSAXHandler::startElement(), and GenericSAXHandler::~GenericSAXHandler().
|
privateinherited |
the map from ids to their string representation
Definition at line 292 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::GenericSAXHandler(), SUMOSAXReader::parseNext(), and GenericSAXHandler::startElement().
|
protected |
The prefix to use.
Definition at line 115 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), and setDefaults().
|
privateinherited |
whether the reader has already seen a schema
Definition at line 322 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::setSchemaSeen(), and GenericSAXHandler::startElement().
|
protected |
reference to shape container in which all Shares are being added
Definition at line 112 of file ShapeHandler.h.
Referenced by addPOI(), addPoly(), PCLoaderXML::getLanePos(), GNEAdditionalHandler::parseAndBuildPOI(), and GNEAdditionalHandler::parseAndBuildPoly().
|
privateinherited |
Definition at line 303 of file GenericSAXHandler.h.
Referenced by GenericSAXHandler::convertTag(), and GenericSAXHandler::GenericSAXHandler().