org.deegree.cs.configuration.wkt
Class WKTParser

java.lang.Object
  org.deegree.cs.configuration.wkt.WKTParser

public class WKTParser
extends java.lang.Object

The WKTParser class instantiates the Coordinate System given in a file, in WKT (Well Known Text) format. The extendend Backus-Naur grammar of WKT as well as a detailed reference are available at the OGC website.

Version:

$Revision: $, $Date: $

Author:

Andrei Ionita, last edited by: $Author: ionita $

Constructor Summary

WKTParser(java.io.File fileName)

WKTParser(java.lang.String fileName)
Constructor

Method Summary

protected boolean	equalsParameterVariants(java.lang.String candidate, java.lang.String paramName)
protected java.lang.String	makeInvariantKey(java.lang.String candidate)
static CoordinateSystem	parse(java.lang.String wkt)
protected CRSCodeType	parseAuthority()
protected Axis	parseAxis()
protected CompoundCRS	parseCompoundCRS() Parses a CompoundCRS from the current WKT location.
CoordinateSystem	parseCoordinateSystem()
protected Ellipsoid	parseEllipsoid()
protected GeocentricCRS	parseGeocentricCRS()
protected GeodeticDatum	parseGeodeticDatum()
protected GeographicCRS	parseGeographiCRS()
protected Helmert	parseHelmert()
protected PrimeMeridian	parsePrimeMeridian()
protected ProjectedCRS	parseProjectedCRS()
protected java.lang.String	parseString()
protected Unit	parseUnit()
protected VerticalCRS	parseVerticalCRS()
protected VerticalDatum	parseVerticalDatum()
protected void	passOverChar(char ch) Walk a character (comma or round/square bracket).
protected void	passOverClosingBracket() Walk a closing bracket (round or square).
protected void	passOverOpeningBracket() Walk an opening bracket (round or square).
protected void	passOverWord(java.lang.String s) Walk a WKT keyword element (e.g.

Methods inherited from class java.lang.Object

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

Constructor Detail

WKTParser

public WKTParser(java.lang.String fileName)
          throws java.io.IOException

Constructor

Parameters:

fileName - the file that contains a Coordinate System definition

Throws:

java.io.IOException - if the provided WKT has a syntax error

WKTParser

public WKTParser(java.io.File fileName)
          throws java.io.FileNotFoundException

Parameters:

fileName - to read a wkt from.

Throws:

java.io.FileNotFoundException

Method Detail

equalsParameterVariants

protected boolean equalsParameterVariants(java.lang.String candidate,
                                          java.lang.String paramName)

Parameters:

candidate -

paramName -

Returns:

true if the candidate stripped of underscores equals ignore case the param name (also stripped).

makeInvariantKey

protected java.lang.String makeInvariantKey(java.lang.String candidate)

passOverChar

protected void passOverChar(char ch)
                     throws java.io.IOException

Walk a character (comma or round/square bracket).

Parameters:

ch -

Throws:

java.io.IOException - if an I/O error occurs.

WKTParsingException - if the expected character is not present at this position.

passOverOpeningBracket

protected void passOverOpeningBracket()
                               throws java.io.IOException

Walk an opening bracket (round or square).

Throws:

java.io.IOException - if an I/O error occurs.

WKTParsingException - if the opening bracket is not present at this position.

passOverClosingBracket

protected void passOverClosingBracket()
                               throws java.io.IOException

Walk a closing bracket (round or square).

Throws:

java.io.IOException - if an I/O error occurs.

WKTParsingException - if the closing bracket is not present at this position.

passOverWord

protected void passOverWord(java.lang.String s)
                     throws java.io.IOException

Walk a WKT keyword element (e.g. DATUM, AUTHORITY, UNIT, etc.)

Parameters:

s - the keyword element as a String

Throws:

java.io.IOException - if an I/O error occurs.

WKTParsingException - if the keyword is not present at this position.

parseAuthority

protected CRSCodeType parseAuthority()
                              throws java.io.IOException

Returns:

a CRSCodeType object based on the information in the AUTHORITY element

Throws:

java.io.IOException - if an I/O error occurs

parseString

protected java.lang.String parseString()
                                throws java.io.IOException

Returns:

the string that is surrounded by double-quotes

Throws:

java.io.IOException - if an I/O error occurs

WKTParsingException - if the string does not begin with have an opening double-quote.

parseAxis

protected Axis parseAxis()
                  throws java.io.IOException

Returns:

an Axis

Throws:

java.io.IOException

WKTParsingException - if the axis orientation is not one of the values defined in the WKT reference ( NORTH | SOUTH | WEST | EAST | UP | DOWN | OTHER )

parseUnit

protected Unit parseUnit()
                  throws java.io.IOException

Returns:

a Unit.

Throws:

java.io.IOException

UnknownUnitException - if the unit name does not match any of the predefined units in the API

parsePrimeMeridian

protected PrimeMeridian parsePrimeMeridian()
                                    throws java.io.IOException

Returns:

a Prime Meridian

Throws:

java.io.IOException

parseEllipsoid

protected Ellipsoid parseEllipsoid()
                            throws java.io.IOException

Returns:

the Ellipsoid parsed from a WKT 'SPHEROID'.

Throws:

java.io.IOException

parseHelmert

protected Helmert parseHelmert()
                        throws java.io.IOException

Returns:

the Helmert transformatio parsed from the WKT 'TOWGS84'

Throws:

java.io.IOException

parseGeodeticDatum

protected GeodeticDatum parseGeodeticDatum()
                                    throws java.io.IOException

Returns:

a Geodetic Datum parsed from WKT 'DATUM'

Throws:

java.io.IOException

parseVerticalDatum

protected VerticalDatum parseVerticalDatum()
                                    throws java.io.IOException

Returns:

a Vertical Datum parsed from WKT 'VERT_DATUM'

Throws:

java.io.IOException

parseVerticalCRS

protected VerticalCRS parseVerticalCRS()
                                throws java.io.IOException

Returns:

a VerticalCRS parsed from the current reader position.

Throws:

java.io.IOException

parseGeocentricCRS

protected GeocentricCRS parseGeocentricCRS()
                                    throws java.io.IOException

Returns:

a GeocentricCRS parsed from the current reader position.

Throws:

java.io.IOException

parseGeographiCRS

protected GeographicCRS parseGeographiCRS()
                                   throws java.io.IOException

Returns:

a GeographicCRS parsed from the current reader position.

Throws:

java.io.IOException

parseProjectedCRS

protected ProjectedCRS parseProjectedCRS()
                                  throws java.io.IOException

Returns:

a ProjectedCRS parsed from the current reader position.

Throws:

java.io.IOException

parseCompoundCRS

protected CompoundCRS parseCompoundCRS()
                                throws java.io.IOException

Parses a CompoundCRS from the current WKT location.

Returns:

a CompoundCRS parsed from the current reader position.

Throws:

java.io.IOException

parseCoordinateSystem

public CoordinateSystem parseCoordinateSystem()
                                       throws java.io.IOException

Returns:

a Coordinate System ( Compound CRS, Projected CRS, Geographic CRS, Geocentric CRS, Vertical CRS)

Throws:

java.io.IOException - if the provided WKT has a syntax error

parse

public static CoordinateSystem parse(java.lang.String wkt)
                              throws java.io.IOException

Parameters:

wkt - the wkt code as a String

Returns:

the parsed CoordinateSystem

Throws:

java.io.IOException - if the provided WKT has a syntax error