Class GMLReader

Hierarchy: Object , GMLReader
public class 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 javax.xml.parsers.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.

Authors:
David Zwiers, Vivid Solutions.
See also:
GMLHandler
public Geometry read(String gml, GeometryFactory geometryFactory)
Reads a GML2 Geometry from a String into a single Geometry If a collection of geometries is found, a GeometryCollection is returned.
Parameters:
gml - gml The GML String to parse
geometryFactory - geometryFactory When null, a default will be used.
See also:
#read(Reader, GeometryFactory)
Returns:
the resulting JTS Geometry
Throws:
ParserConfigurationException - ParserConfigurationException
IOException - IOException
SAXException - SAXException
public Geometry read(Reader reader, GeometryFactory geometryFactory)
Reads a GML2 Geometry from a Reader into a single Geometry If a collection of Geometries is found, a GeometryCollection is returned.
Parameters:
reader - reader The input source
geometryFactory - geometryFactory When null, a default will be used.
Returns:
The resulting JTS Geometry
Throws:
SAXException - SAXException
IOException - IOException