Package org.opentrafficsim.road.network.factory.xml.parser

Class XmlNetworkLaneParser

java.lang.Object

org.opentrafficsim.road.network.factory.xml.parser.XmlNetworkLaneParser

All Implemented Interfaces:

Serializable

public final class XmlNetworkLaneParser
extends Object
implements Serializable

Parse an XML file for an OTS network, based on the ots-network.xsd definition.

Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Jul 23, 2015

Author:

Alexander Verbraeck

See Also:

Serialized Form

Method Summary

Modifier and Type	Method	Description
static Experiment.TimeDoubleUnit<OTSSimulatorInterface>	build(InputStream xmlStream, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts)	Parse the XML input stream and build the network.
static OTSRoadNetwork	build(String filename, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts)	Parse the XML file and build the network.
static Experiment.TimeDoubleUnit<OTSSimulatorInterface>	build(URL xmlURL, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts)	Parse the XML file and build the network.
static Experiment.TimeDoubleUnit<OTSSimulatorInterface>	build(OTS ots, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts)	Build the network from an OTS object (probably constructed by parsing an OTS XML file; e.g.
static void	main(String[] args)
static OTS	parseXML(InputStream xmlStream)	Parse an OTS XML input stream and build an OTS object.
static OTS	parseXML(URL xmlURL)	Parse an OTS XML input stream and build an OTS object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

build

public static OTSRoadNetwork build(String filename, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts) throws JAXBException, URISyntaxException, NetworkException, OTSGeometryException, XmlParserException, SAXException, ParserConfigurationException, SimRuntimeException, GTUException

Parse the XML file and build the network.

Parameters:

filename - String; the name of the file to parse

otsNetwork - OTSRoadNetwork; the network to insert the parsed objects in

simulator - OTSSimulatorInterface; the simulator

buildConflicts - boolean; whether to build conflicts or not

Returns:

the network that contains the parsed objects

Throws:

JAXBException - when the parsing fails

URISyntaxException - when the filename is not valid

NetworkException - when the objects cannot be inserted into the network due to inconsistencies

OTSGeometryException - when the design line of a link is invalid

XmlParserException - when the stripe type cannot be recognized

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

SimRuntimeException - in case of simulation problems building the car generator

GTUException - when construction of the Strategical Planner failed

build

public static Experiment.TimeDoubleUnit<OTSSimulatorInterface> build(InputStream xmlStream, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts) throws JAXBException, URISyntaxException, NetworkException, OTSGeometryException, XmlParserException, SAXException, ParserConfigurationException, SimRuntimeException, GTUException

Parse the XML input stream and build the network.

Parameters:

xmlStream - InputStream; the xml input stream

otsNetwork - OTSRoadNetwork; the network to insert the parsed objects in

simulator - OTSSimulatorInterface; the simulator

buildConflicts - boolean; whether to build conflicts or not

Returns:

the experiment based on the information in the RUN tag

Throws:

JAXBException - when the parsing fails

URISyntaxException - when the filename is not valid

NetworkException - when the objects cannot be inserted into the network due to inconsistencies

OTSGeometryException - when the design line of a link is invalid

XmlParserException - when the stripe type cannot be recognized

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

SimRuntimeException - in case of simulation problems building the car generator

GTUException - when construction of the Strategical Planner failed

parseXML

public static OTS parseXML(URL xmlURL) throws JAXBException, SAXException, ParserConfigurationException

Parse an OTS XML input stream and build an OTS object.

Parameters:

xmlURL - URL; the URL for the xml file or stream

Returns:

OTS; the constructed OTS object

Throws:

JAXBException - when the parsing fails

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

parseXML

public static OTS parseXML(InputStream xmlStream) throws JAXBException, SAXException, ParserConfigurationException

Parse an OTS XML input stream and build an OTS object.

Parameters:

xmlStream - inputStream; the xml stream

Returns:

OTS; the constructed OTS object

Throws:

JAXBException - when the parsing fails

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

build

public static Experiment.TimeDoubleUnit<OTSSimulatorInterface> build(URL xmlURL, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts) throws JAXBException, URISyntaxException, NetworkException, OTSGeometryException, XmlParserException, SAXException, ParserConfigurationException, SimRuntimeException, GTUException

Parse the XML file and build the network.

Parameters:

xmlURL - URL; the URL for the xml input file

otsNetwork - OTSRoadNetwork; the network to insert the parsed objects in

simulator - OTSSimulatorInterface; the simulator

buildConflicts - boolean; whether to build conflicts or not

Returns:

the experiment based on the information in the RUN tag

Throws:

JAXBException - when the parsing fails

URISyntaxException - when the filename is not valid

NetworkException - when the objects cannot be inserted into the network due to inconsistencies

OTSGeometryException - when the design line of a link is invalid

XmlParserException - when the stripe type cannot be recognized

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

SimRuntimeException - in case of simulation problems building the car generator

GTUException - when construction of the Strategical Planner failed

build

public static Experiment.TimeDoubleUnit<OTSSimulatorInterface> build(OTS ots, OTSRoadNetwork otsNetwork, OTSSimulatorInterface simulator, boolean buildConflicts) throws JAXBException, URISyntaxException, NetworkException, OTSGeometryException, XmlParserException, SAXException, ParserConfigurationException, SimRuntimeException, GTUException

Build the network from an OTS object (probably constructed by parsing an OTS XML file; e.g. the parseXML method).

Parameters:

ots - OTS; the OTS object

otsNetwork - OTSRoadNetwork; the network to insert the parsed objects in

simulator - OTSSimulatorInterface; the simulator

buildConflicts - boolean; whether to build conflicts or not

Returns:

the experiment based on the information in the RUN tag

Throws:

JAXBException - when the parsing fails

URISyntaxException - when the filename is not valid

NetworkException - when the objects cannot be inserted into the network due to inconsistencies

OTSGeometryException - when the design line of a link is invalid

XmlParserException - when the stripe type cannot be recognized

ParserConfigurationException - on error with parser configuration

SAXException - on error creating SAX parser

SimRuntimeException - in case of simulation problems building the car generator

GTUException - when construction of the Strategical Planner failed

main

public static void main(String[] args) throws Exception

Parameters:

args - String[]; not used

Throws:

Exception - on parsing error