JTS Topology Suite - v 1.12

## com.vividsolutions.jts.io.gml2
Class GMLReader

    java.lang.Object
      com.vividsolutions.jts.io.gml2.GMLReader

    public class GMLReader

extends java.lang.Object

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:
  `GMLHandler`

Constructor Summary
`GMLReader()`

Method Summary
`Geometry` `read(java.io.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(java.lang.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(java.lang.String gml,
                         GeometryFactory geometryFactory)
                  throws org.xml.sax.SAXException,
                         java.io.IOException,
                         javax.xml.parsers.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:
    `javax.xml.parsers.ParserConfigurationException`
    `java.io.IOException`
    `org.xml.sax.SAXException`
  See Also:
    `read(Reader, GeometryFactory)`

### read

    public Geometry read(java.io.Reader reader,
                         GeometryFactory geometryFactory)
                  throws org.xml.sax.SAXException,
                         java.io.IOException,
                         javax.xml.parsers.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:
    `org.xml.sax.SAXException`
    `java.io.IOException`
    `javax.xml.parsers.ParserConfigurationException`

JTS Topology Suite - v 1.12