Module org.apache.sis.referencing

Package org.apache.sis.io.wkt

Interface Parser

All Known Implementing Classes:

Default­Math­Transform­Factory, Geodetic­Object­Factory

public interface Parser

A parser or a factory capable to create an object from a string in the WKT format. The created objects may be Coordinate Reference Systems, Math Transforms or geometric objects for instance.

Parsing services may be provided by factories which implement this interface:

• Geodetic­Object­Factory.create­From­WKT(String)
• Default­Math­Transform­Factory.create­From­WKT(String)

Similar services are also available as convenience static methods:

• CRS.from­WKT(String)
• Envelopes.from­WKT(Char­Sequence)

Non-fatal anomalies found in Well Known Texts are reported in a logger named "org.apache.sis.io.wkt". Warnings may be for unknown or unsupported WKT elements, inconsistent unit definitions (unit symbol, scale factor or EPSG code), unparsable axis abbreviations, etc. However, this parser does not verify if the overall parsed object matches the EPSG (or other authority) definition. For such verification, see CRS.from­WKT(String).

Since:

0.6

Method Summary

Modifier and Type	Method	Description
Object	create­From­WKT(String text)	Creates the object from a string.

Method Details

createFromWKT

Object createFromWKT(String text)
              throws FactoryException

Creates the object from a string. Objects returned by this method are typically (but not necessarily) Coordinate Reference Systems or Math Transforms. If the given text contains non-fatal anomalies, warnings may be reported in a logger named "org.apache.sis.io.wkt".

Handling of warnings

For processing warnings in a different way than logging them, one can use Compound­Format.parse­Object(String) followed by a call to WKTFormat.get­Warnings().

Parameters:

text - object encoded in Well-Known Text format (version 1 or 2).

Returns:

the result of parsing the given text.

Throws:

Factory­Exception - if the object creation failed.