org.geotools.geometry.iso.text

Class WKTParser

Object

WKTParser

public class WKTParser
extends Object

This class is used to parse well known text (WKT) which describes an ISO 19107 Geometry. The grammar described comes from the ISO 19125-1 spec which describes feature geometry. It doesn't seem to exactly mesh up with the geometry as described in 19107 so not all of the grammar is supported.

The types in the WKT format, and their mappings:

• POINT org.opengis.geometry.primitive.Point
• LINESTRING org.opengis.geometry.primitive.Curve
• POLYGON org.opengis.geometry.primitive.Surface
• MULTIPOINT org.opengis.geometry.coordinate.aggregate.MultiPoint Note that there is no factory method for MultiPoint.
  For now, to keep implementation-independance I'm returning it as a List
• MULTILINESTRING no matching type in the GeoAPI interfaces Could also be returned as list.
  Not handled for now
• MULTIPOLYGON no matching type in the GeoAPI interfaces Could also be returned as list.
  Not handled for now

> Please note that this parser is not thread safe; you can however reuse the parser.

Since:

2.5

Author:

Jody Garnett, Joel Skelton

Constructor Summary

Constructors

Constructor and Description
WKTParser(GeometryBuilder builder)
WKTParser(GeometryFactory geometryFactory, PrimitiveFactory primitiveFactory, PositionFactory positionFactory, AggregateFactory aggregateFactory) Constructor takes pre-created geometry and primitive factories that will be used to parse the Well Known Text (WKT).

Method Summary

Modifier and Type	Method and Description
Geometry	parse(String text) Takes a string containing well known text geometry description and wraps it in a Reader which is then passed on to parseWKT for handling.
Geometry	read(Reader reader) Reads a Well-Known Text representation of a geometry from a Reader.
void	setFactory(GeometryFactory factory) Provide a GeometryFactory for the parser.
void	setFactory(PositionFactory factory) Provide a PositionFactory for the parser.
void	setFactory(PrimitiveFactory factory) Provide a PrimitiveFactory for the parser.

Methods inherited from class Object

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

Constructor Detail

WKTParser

public WKTParser(GeometryBuilder builder)

WKTParser

public WKTParser(GeometryFactory geometryFactory,
                 PrimitiveFactory primitiveFactory,
                 PositionFactory positionFactory,
                 AggregateFactory aggregateFactory)

Constructor takes pre-created geometry and primitive factories that will be used to parse the Well Known Text (WKT). The geometries created from the WKT will be created in the CoordinateReferenceSystem

Parameters:

geometryFactory - A GeometryFactory created with a CoordinateReferenceSystem and PrecisionModel

primitiveFactory - A PrimitiveFactory created with the same crs and precision as above

positionFactory - A PositionFactory created with the same crs and precision as above

aggregateFactory - A AggregateFactory created with the same crs and precision as above

Method Detail

setFactory

public void setFactory(GeometryFactory factory)

Provide a GeometryFactory for the parser.

Should be called prior to use.

setFactory

public void setFactory(PrimitiveFactory factory)

Provide a PrimitiveFactory for the parser.

Should be called prior to use.

setFactory

public void setFactory(PositionFactory factory)

Provide a PositionFactory for the parser.

Should be called prior to use.

parse

public Geometry parse(String text)
               throws ParseException

Takes a string containing well known text geometry description and wraps it in a Reader which is then passed on to parseWKT for handling.

Parameters:

text - A string containing the well known text to be parsed.

Returns:

Geometry indicated by text (as created with current factories)

Throws:

ParseException

read

public Geometry read(Reader reader)
              throws ParseException

Reads a Well-Known Text representation of a geometry from a Reader.

Parameters:

reader - a Reader which will return a [Geometry Tagged Text] string (see the OpenGIS Simple Features Specification)

Returns:

a Geometry read from reader

Throws:

ParseException - if a parsing problem occurs