com.vividsolutions.jts.io.gml2

Class GMLReader

java.lang.Object

com.vividsolutions.jts.io.gml2.GMLReader

public class GMLReader
extends Object

Reads a GML2 geometry from an XML fragment into a Geometry.

An example of the GML2 format handled is:

   
        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 
  
 

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:

GMLHandler

Constructor Summary

Constructors

Constructor and Description
GMLReader()

Method Summary

Methods

Modifier and Type	Method and Description
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.
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.

Methods inherited from class java.lang.Object

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

Constructor Detail

GMLReader

public GMLReader()

Method Detail

read

public Geometry read(String gml,
            GeometryFactory geometryFactory)
              throws SAXException,
                     IOException,
                     ParserConfigurationException

Reads a GML2 Geometry from a String into a single Geometry If a collection of geometries is found, a GeometryCollection is returned.

Parameters:

gml - The GML String to parse

geometryFactory - When null, a default will be used.

Returns:

the resulting JTS Geometry

Throws:

ParserConfigurationException

IOException

SAXException

See Also:

read(Reader, GeometryFactory)

read

public Geometry read(Reader reader,
            GeometryFactory geometryFactory)
              throws SAXException,
                     IOException,
                     ParserConfigurationException

Reads a GML2 Geometry from a Reader into a single Geometry If a collection of Geometries is found, a GeometryCollection is returned.

Parameters:

reader - The input source

geometryFactory - When null, a default will be used.

Returns:

The resulting JTS Geometry

Throws:

SAXException

IOException

ParserConfigurationException