Class GMLReader
java.lang.Object
org.locationtech.jts.io.gml2.GMLReader
Reads a GML2 geometry from an XML fragment into a
Geometry.
An example of the GML2 format handled is:
<LineString>
<coordinates>
24824.045318333192,38536.15071012041
26157.378651666528,37567.42733944659 26666.666,36000.0
26157.378651666528,34432.57266055341
24824.045318333192,33463.84928987959
23175.954681666804,33463.84928987959
21842.621348333472,34432.57266055341 21333.333,36000.0
21842.621348333472,37567.42733944659
23175.954681666808,38536.15071012041
</coordinates>
</LineString>
The reader ignores namespace prefixes,
and disables both the validation and namespace options on the SAXParser.
This class requires the presence of a SAX Parser available via the
SAXParserFactory.newInstance()
method.
A specification of the GML XML format can be found at the OGC web site: http://www.opengeospatial.org/.
It is the caller's responsibility to ensure that the supplied PrecisionModel
matches the precision of the incoming data.
If a lower precision for the data is required, a subsequent
process must be run on the data to reduce its precision.
To parse and build geometry directly from a SAX stream, see GMLHandler.
- Author:
- David Zwiers, Vivid Solutions.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionread(Reader reader, GeometryFactory geometryFactory) Reads a GML2 Geometry from aReaderinto a singleGeometryIf a collection of Geometries is found, aGeometryCollectionis returned.read(String gml, GeometryFactory geometryFactory) Reads a GML2 Geometry from a String into a singleGeometryIf a collection of geometries is found, aGeometryCollectionis returned.
-
Constructor Details
-
GMLReader
public GMLReader()
-
-
Method Details
-
read
public Geometry read(String gml, GeometryFactory geometryFactory) throws SAXException, IOException, ParserConfigurationException Reads a GML2 Geometry from a String into a singleGeometryIf a collection of geometries is found, aGeometryCollectionis returned.- Parameters:
gml- The GML String to parsegeometryFactory- When null, a default will be used.- Returns:
- the resulting JTS Geometry
- Throws:
ParserConfigurationExceptionIOExceptionSAXException- See Also:
-
read
public Geometry read(Reader reader, GeometryFactory geometryFactory) throws SAXException, IOException, ParserConfigurationException Reads a GML2 Geometry from aReaderinto a singleGeometryIf a collection of Geometries is found, aGeometryCollectionis returned.- Parameters:
reader- The input sourcegeometryFactory- When null, a default will be used.- Returns:
- The resulting JTS Geometry
- Throws:
SAXExceptionIOExceptionParserConfigurationException
-