Inheritance diagram for org.matsim.core.utils.io.MatsimXmlParser:

[legend]

Classes
enum	ValidationType

Public Member Functions
	MatsimXmlParser (ValidationType validationType)

abstract void	startTag (String name, Attributes atts, Stack< String > context)

abstract void	endTag (String name, String content, Stack< String > context)

final void	setValidating (final boolean validateXml)

final void	setNamespaceAware (final boolean awareness)

final void	setLocalDtdDirectory (final String localDtdDirectory)

final void	readFile (final String filename) throws UncheckedIOException

final void	readURL (final URL url) throws UncheckedIOException

final void	readStream (InputStream stream) throws UncheckedIOException

final void	parse (final URL url) throws UncheckedIOException

final void	parse (final InputStream stream) throws UncheckedIOException

final void	parse (final InputSource input) throws UncheckedIOException

final String	getDoctype ()

final InputSource	resolveEntity (final String publicId, final String systemId)

void	characters (final char[] ch, final int start, final int length) throws SAXException

final void	startElement (final String uri, final String localName, final String qName, Attributes atts)

final void	endElement (final String uri, final String localName, final String qName) throws SAXException

final void	error (final SAXParseException ex) throws SAXException

final void	fatalError (final SAXParseException ex) throws SAXException

final void	warning (final SAXParseException ex) throws SAXException

Static Public Member Functions
static double	parseDouble (String value) throws NumberFormatException

Protected Member Functions
void	setDoctype (final String doctype)

Private Member Functions
InputSource	findDtdInLocalFilesystem (final String shortSystemId)

InputSource	findDtdInClasspath (final String shortSystemId)

String	getInputSource (final SAXParseException ex)

Static Private Member Functions
static InputSource	findDtdInRemoteLocation (final String fullSystemId)

static InputSource	findDtdInDefaultLocation (final String shortSystemId)

Private Attributes
final Stack< StringBuffer >	buffers = new Stack<>()

final Stack< String >	theContext = new Stack<>()

boolean	isValidating = true

boolean	isNamespaceAware = true

final ValidationType	validationType

String	localDtdBase = null

final boolean	preferLocalDtds

String	doctype = null

String	theSource

Static Private Attributes
static final Logger	log = LogManager.getLogger(MatsimXmlParser.class)

Detailed Description

An abstract XML-Parser which can be easily extended for reading custom XML-formats. This class handles all the low level functionality required to parse xml-files. Extending classes have only to implement startTag and endTag to implement a custom parser.
The parser implements a custom EntityResolver to look for DTDs in the MATSim world.

Notes:

If implementing classes want to override the final methods, the will have to resort to delegation.

Author: mrieser

Definition at line 55 of file MatsimXmlParser.java.

Constructor & Destructor Documentation

◆ MatsimXmlParser()

org.matsim.core.utils.io.MatsimXmlParser.MatsimXmlParser ( ValidationType validationType )

Creates a validating XML-parser.

Parameters

validationType hint whether DTD or XSD is expected for validation, helps to optimize the parser for performance.

Definition at line 86 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.endTag(), org.matsim.utils.FeatureFlags.preferLocalDTDs(), org.matsim.core.utils.io.MatsimXmlParser.startTag(), and org.matsim.core.utils.io.MatsimXmlParser.validationType.

                                                           {
         this.validationType = validationType;
         this.preferLocalDtds = FeatureFlags.preferLocalDTDs();
     }

Here is the call graph for this function:

Member Function Documentation

◆ startTag()

abstract void org.matsim.core.utils.io.MatsimXmlParser.startTag	(	String	name,
		Attributes	atts,
		Stack< String >	context
	)

abstract

Called for each opening xml-tag.

Parameters

name	the name of the xml-tag
atts	the list of attributes and their values
context	a stack containing the path/hierarchy to the current tag

Referenced by org.matsim.core.utils.io.MatsimXmlParser.MatsimXmlParser(), org.matsim.core.utils.io.MatsimXmlParser.startElement(), org.matsim.matrices.MatsimMatricesReader.startTag(), org.matsim.core.config.ConfigReader.startTag(), org.matsim.core.network.io.MatsimNetworkReader.startTag(), org.matsim.counts.MatsimCountsReader.startTag(), org.matsim.core.population.io.PopulationReader.startTag(), org.matsim.pt.transitSchedule.api.TransitScheduleReader.XmlScheduleReader.startTag(), and org.matsim.facilities.MatsimFacilitiesReader.startTag().

◆ endTag()

abstract void org.matsim.core.utils.io.MatsimXmlParser.endTag	(	String	name,
		String	content,
		Stack< String >	context
	)

abstract

Called for each closing xml-tag.

Parameters

name	the name of the xml-tag.
content	the character-content of the tag; any characters between `<tag>` and `</tag>>`, excluding other tags and their content.
context	a stack containing the path/hierarchy to the current tag

Referenced by org.matsim.core.utils.io.MatsimXmlParser.endElement(), org.matsim.matrices.MatsimMatricesReader.endTag(), org.matsim.core.config.ConfigReader.endTag(), org.matsim.core.network.io.MatsimNetworkReader.endTag(), org.matsim.vehicles.MatsimVehicleReader.VehicleReader.endTag(), org.matsim.counts.MatsimCountsReader.endTag(), org.matsim.core.population.io.PopulationReader.endTag(), org.matsim.pt.transitSchedule.api.TransitScheduleReader.XmlScheduleReader.endTag(), org.matsim.facilities.MatsimFacilitiesReader.endTag(), and org.matsim.core.utils.io.MatsimXmlParser.MatsimXmlParser().

◆ setValidating()

final void org.matsim.core.utils.io.MatsimXmlParser.setValidating ( final boolean validateXml )

Sets, if this parser should validate the read XML or not. Not validating is sometimes useful during development or during some tests with format-extensions that are not yet part of the DTD, but it is strongly discouraged not to validate during production use.

Parameters

validateXml Whether the parsed XML should be validated or not.

Definition at line 117 of file MatsimXmlParser.java.

Referenced by org.matsim.core.events.EventsConverterXML.EventsConverterXML(), and org.matsim.core.events.EventsReaderXMLv1.EventsReaderXMLv1().

                                                                {
         this.isValidating = validateXml;
     }

◆ setNamespaceAware()

final void org.matsim.core.utils.io.MatsimXmlParser.setNamespaceAware ( final boolean awareness )

Specifies that the parser produced by this code will provide support for XML namespaces. By default the value of this is set to false.

Parameters

awareness true if the parser produced by this code will provide support for XML namespaces; false otherwise.

See also: javax.xml.parsers.SAXParserFactory::setNamespaceAware(boolean)

Definition at line 128 of file MatsimXmlParser.java.

                                                                  {
         this.isNamespaceAware = awareness;
     }

◆ setLocalDtdDirectory()

final void org.matsim.core.utils.io.MatsimXmlParser.setLocalDtdDirectory ( final String localDtdDirectory )

Sets the directory where to look for DTD and XSD files if they are not found at the location specified in the XML.

Parameters

localDtdDirectory

Definition at line 138 of file MatsimXmlParser.java.

                                                                            {
         this.localDtdBase = localDtdDirectory;
     }

◆ readFile()

final void org.matsim.core.utils.io.MatsimXmlParser.readFile ( final String filename ) throws UncheckedIOException

Parses the specified file. The file can be gzip-compressed and is decompressed on-the-fly while parsing. A gzip-compressed file must have the ending ".gz" to be correctly recognized. The passed filename may or may not contain the ending ".gz". If no uncompressed file is found with the specified name, the ending ".gz" will be added to the filename and a compressed file will be searched for and read if found.

Parameters

filename The filename of the file to read, optionally ending with ".gz" to force reading a gzip-compressed file.

Exceptions

UncheckedIOException

Implements org.matsim.core.api.internal.MatsimReader.

Definition at line 152 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.IOUtils.getBufferedReader(), and org.matsim.core.utils.io.MatsimXmlParser.parse().

Referenced by org.matsim.utils.gis.matsim2esri.plans.SelectedPlans2ESRIShape.main(), org.matsim.core.utils.io.OsmNetworkReader.parse(), org.matsim.vehicles.MatsimVehicleReader.readFile(), org.matsim.pt.transitSchedule.api.TransitScheduleReader.readFile(), org.matsim.core.events.MatsimEventsReader.readFile(), org.matsim.core.population.io.StreamingPopulationReader.readFile(), org.matsim.core.network.NetworkUtils.readNetwork(), org.matsim.core.population.PopulationUtils.readPopulation(), org.matsim.core.network.algorithms.intersectionSimplifier.RunIntersectionSimplifier.run(), and org.matsim.run.gui.ScheduleValidatorWindow.run().

                                                                                   {
         log.info("starting to parse xml from file " + filename + " ...");
         this.theSource = filename;
         parse(new InputSource(IOUtils.getBufferedReader(filename)));
     }

Here is the call graph for this function:

◆ readURL()

final void org.matsim.core.utils.io.MatsimXmlParser.readURL ( final URL url ) throws UncheckedIOException

Implements org.matsim.core.api.internal.MatsimReader.

Definition at line 159 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.parse().

Referenced by org.matsim.vehicles.MatsimVehicleReader.readURL(), and org.matsim.core.events.MatsimEventsReader.readURL().

                                                                            {
         parse( url ) ;
     }

Here is the call graph for this function:

◆ readStream()

final void org.matsim.core.utils.io.MatsimXmlParser.readStream ( InputStream stream ) throws UncheckedIOException

Definition at line 163 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.parse().

                                                                                  {
         parse(stream);
     }

Here is the call graph for this function:

◆ parse() [1/3]

final void org.matsim.core.utils.io.MatsimXmlParser.parse ( final URL url ) throws UncheckedIOException

Definition at line 167 of file MatsimXmlParser.java.

References org.matsim.core.gbl.Gbl.assertNotNull(), and org.matsim.core.utils.io.IOUtils.getBufferedReader().

Referenced by org.matsim.core.config.ConfigUtils.loadConfig(), org.matsim.core.population.io.StreamingPopulationReader.parse(), org.matsim.core.utils.io.MatsimXmlParser.parse(), org.matsim.core.utils.io.OsmNetworkReader.parse(), org.matsim.core.utils.io.MatsimXmlParser.readFile(), org.matsim.vehicles.MatsimVehicleReader.readStream(), org.matsim.pt.transitSchedule.api.TransitScheduleReader.readStream(), org.matsim.core.events.MatsimEventsReader.readStream(), org.matsim.core.utils.io.MatsimXmlParser.readStream(), org.matsim.pt.transitSchedule.api.TransitScheduleReader.readURL(), org.matsim.core.population.io.StreamingPopulationReader.readURL(), and org.matsim.core.utils.io.MatsimXmlParser.readURL().

                                                                        {
         Gbl.assertNotNull(url);
         this.theSource = url.toString();
         log.info("starting to parse xml from url " + this.theSource + " ...");
         System.out.flush();
         parse(new InputSource(IOUtils.getBufferedReader(this.theSource)));
     }

Here is the call graph for this function:

◆ parse() [2/3]

final void org.matsim.core.utils.io.MatsimXmlParser.parse ( final InputStream stream ) throws UncheckedIOException

Definition at line 175 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.parse().

                                                                                   {
         this.theSource = "stream";
         parse(new InputSource(stream));
     }

Here is the call graph for this function:

◆ parse() [3/3]

final void org.matsim.core.utils.io.MatsimXmlParser.parse ( final InputSource input ) throws UncheckedIOException

Definition at line 180 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.ValidationType.DTD_ONLY, and org.matsim.core.utils.io.MatsimXmlParser.ValidationType.NO_VALIDATION.

                                                                                  {
         try {
             boolean validating = this.isValidating && this.validationType != ValidationType.NO_VALIDATION;
             boolean useWstxParser = !validating || this.validationType == ValidationType.DTD_ONLY;
 
             if (useWstxParser) {
                 // use Woodstox-library as XML parser when no validation or only DTD-validation is required, as it is much faster than the default (xerces)
 
                 WstxSAXParserFactory factory = new WstxSAXParserFactory();
                 factory.setValidating(validating);
                 factory.setNamespaceAware(this.isNamespaceAware);
                 factory.setFeature("http://xml.org/sax/features/external-general-entities", false); // prevent XEE attack: https://en.wikipedia.org/wiki/XML_external_entity_attack
 
                 if (validating) {
                     factory.setFeature("http://xml.org/sax/features/validation", true); // required to enable DTD validation in Woodstox
                     SAXParser parser = factory.newSAXParser();
                     XMLReader reader = parser.getXMLReader();
                     reader.setContentHandler(this);
                     reader.setErrorHandler(this);
                     reader.setEntityResolver(this);
                     reader.parse(input);
                 } else {
                     SAXParser parser = factory.newSAXParser();
                     parser.parse(input, this);
                 }
 
             } else {
                 // use the default (Xerces) SAX parser, it is slower than Woodstox, but supports XSD validation
 
                 SAXParserFactory factory = SAXParserFactory.newInstance();
                 factory.setValidating(validating);
                 factory.setNamespaceAware(this.isNamespaceAware);
                 factory.setFeature("http://xml.org/sax/features/external-general-entities", false); // prevent XEE attack: https://en.wikipedia.org/wiki/XML_external_entity_attack
 
                 if (validating) {
                     // enable optional support for XML Schemas
                     factory.setFeature("http://apache.org/xml/features/validation/schema", true);
                     SAXParser parser = factory.newSAXParser();
                     XMLReader reader = parser.getXMLReader();
                     reader.setContentHandler(this);
                     reader.setErrorHandler(this);
                     reader.setEntityResolver(this);
                     reader.parse(input);
                 } else {
                     SAXParser parser = factory.newSAXParser();
                     parser.parse(input, this);
                 }
             }
         } catch (IOException e) {
             throw new UncheckedIOException(e);
         } catch (SAXException | ParserConfigurationException e) {
             throw new UncheckedIOException(new IOException(e));
         }
     }

◆ getDoctype()

final String org.matsim.core.utils.io.MatsimXmlParser.getDoctype ( )

Definition at line 235 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.doctype.

                                      {
         return this.doctype;
     }

◆ setDoctype()

void org.matsim.core.utils.io.MatsimXmlParser.setDoctype ( final String doctype )

protected

Definition at line 239 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.doctype.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.resolveEntity().

                                                     {
         // implementation of this method is what reacts to the different version of the file formats, so we cannot make it final. kai, jul'16
 
         this.doctype = doctype;
     }

◆ resolveEntity()

final InputSource org.matsim.core.utils.io.MatsimXmlParser.resolveEntity	(	final String	publicId,
		final String	systemId
	)

Definition at line 248 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.findDtdInClasspath(), org.matsim.core.utils.io.MatsimXmlParser.findDtdInDefaultLocation(), org.matsim.core.utils.io.MatsimXmlParser.findDtdInLocalFilesystem(), org.matsim.core.utils.io.MatsimXmlParser.findDtdInRemoteLocation(), and org.matsim.core.utils.io.MatsimXmlParser.setDoctype().

                                                                                          {
         // ConfigReader* did override this.  Not sure if it did that for good reasons.  kai, jul'16
 
         // extract the last part of the systemId
         int index = systemId.replace('\\', '/').lastIndexOf('/');
         String shortSystemId = systemId.substring(index + 1);
 
         if (this.doctype == null) {
             // this is the first systemId we have to resolve, assume it's the doctype
             // I haven't found any other way to determine the doctype of the currently read file
             setDoctype(shortSystemId);
         }
 
         InputSource source;
         if (this.preferLocalDtds) {
             source = findDtdInLocalFilesystem(shortSystemId);
             if (source == null) {
                 source = findDtdInClasspath(shortSystemId);
             }
             if (source == null) {
                 source = findDtdInDefaultLocation(shortSystemId);
             }
             if (source == null) {
                 source = findDtdInRemoteLocation(systemId);
             }
         } else {
             source = findDtdInRemoteLocation(systemId);
             if (source == null) {
                 source = findDtdInLocalFilesystem(shortSystemId);
             }
             if (source == null) {
                 source = findDtdInClasspath(shortSystemId);
             }
             if (source == null) {
                 source = findDtdInDefaultLocation(shortSystemId);
             }
         }
 
         if (source == null) {
             // We could neither get the remote nor the local version of the dtd, show a warning
             log.warn("Could neither get the DTD from the web nor a local one. " + systemId);
         } else {
             source.setSystemId(systemId);
         }
         return source;
     }

Here is the call graph for this function:

◆ findDtdInRemoteLocation()

static InputSource org.matsim.core.utils.io.MatsimXmlParser.findDtdInRemoteLocation ( final String fullSystemId )

staticprivate

Definition at line 295 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.resolveEntity().

                                                                                   {
         log.info("Trying to load " + fullSystemId + ". In some cases (e.g. network interface up but no connection), this may take a bit.");
         try {
             URL url = new URL(fullSystemId);
             URLConnection urlConn = url.openConnection();
             urlConn.setConnectTimeout(5000);
             urlConn.setReadTimeout(5000);
             urlConn.setAllowUserInteraction(false);
 
             InputStream is = urlConn.getInputStream();
             /* If there was no exception until here, then the path is valid.
              * Return the opened stream as a source. If we would return null, then the SAX-Parser
              * would have to fetch the same file again, requiring two accesses to the webserver */
             return new InputSource(is);
         } catch (IOException e) {
             // There was a problem getting the (remote) file, just show the error as information for the user
             log.info(e.toString() + ". May not be fatal, will try to load it locally.");
         }
         return null;
     }

◆ findDtdInLocalFilesystem()

InputSource org.matsim.core.utils.io.MatsimXmlParser.findDtdInLocalFilesystem ( final String shortSystemId )

private

Definition at line 316 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.resolveEntity().

                                                                              {
         if (this.localDtdBase != null) {
             String localFileName = this.localDtdBase + "/" + shortSystemId;
             File dtdFile = new File(localFileName);
 //          log.debug("dtdfile: " + dtdFile.getAbsolutePath());
             if (dtdFile.exists() && dtdFile.isFile() && dtdFile.canRead()) {
                 log.info("Using the local DTD " + localFileName + " with absolute path " + dtdFile.getAbsolutePath() );
                 return new InputSource(dtdFile.getAbsolutePath());
             }
         }
         return null;
     }

◆ findDtdInClasspath()

InputSource org.matsim.core.utils.io.MatsimXmlParser.findDtdInClasspath ( final String shortSystemId )

private

Definition at line 329 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.resolveEntity().

                                                                        {
         // still no success, try to load it with the ClassLoader, in case we're stuck in a jar...
         InputStream stream = this.getClass().getResourceAsStream("/dtd/" + shortSystemId);
         if (stream != null) {
             log.info("Using local DTD from classpath:dtd/" + shortSystemId);
             return new InputSource(stream);
         }
         return null;
     }

◆ findDtdInDefaultLocation()

static InputSource org.matsim.core.utils.io.MatsimXmlParser.findDtdInDefaultLocation ( final String shortSystemId )

staticprivate

Definition at line 339 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.resolveEntity().

                                                                                     {
         log.info("Trying to access local dtd folder at standard location ./dtd...");
         File dtdFile = new File("./dtd/" + shortSystemId);
         if (dtdFile.exists() && dtdFile.isFile() && dtdFile.canRead()) {
             log.info("Using the local DTD " + dtdFile.getAbsolutePath());
             return new InputSource(dtdFile.getAbsolutePath());
         }
         return null;
     }

◆ characters()

void org.matsim.core.utils.io.MatsimXmlParser.characters	(	final char []	ch,
		final int	start,
		final int	length
	)		throws SAXException

Definition at line 352 of file MatsimXmlParser.java.

                                                                                                    {
         // has to be non-final since otherwise the events parser does not work.  Probably ok (this here is just a default implementation). kai, jul'16
 
         StringBuffer buffer = this.buffers.peek();
         if (buffer != null) {
             buffer.append(ch, start, length);
         }
     }

◆ startElement()

final void org.matsim.core.utils.io.MatsimXmlParser.startElement	(	final String	uri,
		final String	localName,
		final String	qName,
		Attributes	atts
	)

Definition at line 362 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.startTag().

                                                                                                                   {
         // I have not good intuition if making this one non-final might be ok.  kai, jul'16
 
         String tag = (uri.length() == 0) ? qName : localName;
         this.buffers.push(new StringBuffer());
         this.startTag(tag, atts, this.theContext);
         this.theContext.push(tag);
     }

Here is the call graph for this function:

◆ endElement()

final void org.matsim.core.utils.io.MatsimXmlParser.endElement	(	final String	uri,
		final String	localName,
		final String	qName
	)		throws SAXException

Definition at line 372 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.endTag(), and org.matsim.core.utils.io.MatsimXmlParser.theContext.

                                                                                                                    {
         // I have not good intuition if making this one non-final might be ok.  kai, jul'16
 
         String tag = (uri.length() == 0) ? qName : localName;
         this.theContext.pop();
         StringBuffer buffer = this.buffers.pop();
         this.endTag(tag, buffer.toString(), this.theContext);
     }

Here is the call graph for this function:

◆ error()

final void org.matsim.core.utils.io.MatsimXmlParser.error ( final SAXParseException ex ) throws SAXException

Definition at line 384 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.getInputSource().

                                                                             {
         if (this.theContext.isEmpty()) {
             System.err.println("Missing DOCTYPE.");
         }
         System.err.println("XML-ERROR: " + getInputSource(ex) + ", line " + ex.getLineNumber() + ", column " + ex.getColumnNumber() + ":");
         System.err.println(ex.toString());
         throw ex;
     }

Here is the call graph for this function:

◆ fatalError()

final void org.matsim.core.utils.io.MatsimXmlParser.fatalError ( final SAXParseException ex ) throws SAXException

Definition at line 394 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.getInputSource().

                                                                                  {
         System.err.println("XML-FATAL: " + getInputSource(ex) + ", line " + ex.getLineNumber() + ", column " + ex.getColumnNumber() + ":");
         System.err.println(ex.toString());
         throw ex;
     }

Here is the call graph for this function:

◆ warning()

final void org.matsim.core.utils.io.MatsimXmlParser.warning ( final SAXParseException ex ) throws SAXException

Definition at line 401 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.getInputSource().

                                                                               {
         System.err.println("XML-WARNING: " + getInputSource(ex) + ", line " + ex.getLineNumber() + ", column " + ex.getColumnNumber() + ":");
         System.err.println(ex.getMessage());
     }

Here is the call graph for this function:

◆ getInputSource()

String org.matsim.core.utils.io.MatsimXmlParser.getInputSource ( final SAXParseException ex )

private

Definition at line 406 of file MatsimXmlParser.java.

References org.matsim.core.utils.io.MatsimXmlParser.theSource.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.error(), org.matsim.core.utils.io.MatsimXmlParser.fatalError(), and org.matsim.core.utils.io.MatsimXmlParser.warning().

                                                               {
         System.out.println(ex.getPublicId());
         System.out.println(ex.getSystemId());
         if (ex.getCause() != null) {
             System.out.println(ex.getCause().getMessage());
         }
         System.out.println(ex.getLocalizedMessage());
         System.out.println(ex.getMessage());
         if (ex.getSystemId() != null) {
             return ex.getSystemId();
         }
         else if (ex.getPublicId() != null) {
             return ex.getPublicId();
         }
         //try to use the locally stored inputSource
         return this.theSource;
     }

◆ parseDouble()

static double org.matsim.core.utils.io.MatsimXmlParser.parseDouble ( String value ) throws NumberFormatException

static

Parses a String into a double, taking into account the special encoding for Infinity according to the xsd-specifications for the xs:double data type

Definition at line 426 of file MatsimXmlParser.java.

                                                                                 {
         if ("INF".equals(value)) {
             return Double.POSITIVE_INFINITY;
         }
         if ("-INF".equals(value)) {
             return Double.NEGATIVE_INFINITY;
         }
         if ("NaN".equals(value)) {
             return Double.NaN;
         }
         return Double.parseDouble(value);
     }

Member Data Documentation

◆ log

final Logger org.matsim.core.utils.io.MatsimXmlParser.log = LogManager.getLogger(MatsimXmlParser.class)

staticprivate

Definition at line 59 of file MatsimXmlParser.java.

◆ buffers

final Stack<StringBuffer> org.matsim.core.utils.io.MatsimXmlParser.buffers = new Stack<>()

private

Definition at line 61 of file MatsimXmlParser.java.

◆ theContext

final Stack<String> org.matsim.core.utils.io.MatsimXmlParser.theContext = new Stack<>()

private

Definition at line 62 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.endElement().

◆ isValidating

boolean org.matsim.core.utils.io.MatsimXmlParser.isValidating = true

private

Definition at line 64 of file MatsimXmlParser.java.

◆ isNamespaceAware

boolean org.matsim.core.utils.io.MatsimXmlParser.isNamespaceAware = true

private

Definition at line 65 of file MatsimXmlParser.java.

◆ validationType

final ValidationType org.matsim.core.utils.io.MatsimXmlParser.validationType

private

Definition at line 66 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.MatsimXmlParser().

◆ localDtdBase

String org.matsim.core.utils.io.MatsimXmlParser.localDtdBase = null

private

Definition at line 68 of file MatsimXmlParser.java.

◆ preferLocalDtds

final boolean org.matsim.core.utils.io.MatsimXmlParser.preferLocalDtds

private

Definition at line 72 of file MatsimXmlParser.java.

◆ doctype

String org.matsim.core.utils.io.MatsimXmlParser.doctype = null

private

Definition at line 74 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.getDoctype(), and org.matsim.core.utils.io.MatsimXmlParser.setDoctype().

◆ theSource

String org.matsim.core.utils.io.MatsimXmlParser.theSource

private

As the mechanism implemented in InputSource is not really working for error handling the source to be parsed is stored here for error handling.

Definition at line 79 of file MatsimXmlParser.java.

Referenced by org.matsim.core.utils.io.MatsimXmlParser.getInputSource().

The documentation for this class was generated from the following file:

core/utils/io/MatsimXmlParser.java

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ MatsimXmlParser()

Member Function Documentation

◆ startTag()

◆ endTag()

◆ setValidating()

◆ setNamespaceAware()

◆ setLocalDtdDirectory()

◆ readFile()

◆ readURL()

◆ readStream()

◆ parse() [1/3]

◆ parse() [2/3]

◆ parse() [3/3]

◆ getDoctype()

◆ setDoctype()

◆ resolveEntity()

◆ findDtdInRemoteLocation()

◆ findDtdInLocalFilesystem()

◆ findDtdInClasspath()

◆ findDtdInDefaultLocation()

◆ characters()

◆ startElement()

◆ endElement()

◆ error()

◆ fatalError()

◆ warning()

◆ getInputSource()

◆ parseDouble()

Member Data Documentation

◆ log

◆ buffers

◆ theContext

◆ isValidating

◆ isNamespaceAware

◆ validationType

◆ localDtdBase

◆ preferLocalDtds

◆ doctype

◆ theSource