org.deegree.crs.configuration.deegree.xml.stax.parsers
Class CoordinateSystemParser

java.lang.Object
  org.deegree.crs.configuration.deegree.xml.stax.parsers.DefinitionParser
      org.deegree.crs.configuration.deegree.xml.stax.parsers.CoordinateSystemParser

public class CoordinateSystemParser
extends DefinitionParser

A stax based 0.4.0 crs configuration parser for Coordinate system objects.

Version:

$Revision: 22662 $, $Date: 2010-02-19 14:51:52 +0100 (Fr, 19 Feb 2010) $

Author:

Rutger Bezema, last edited by: $Author: mschneider $

Constructor Summary

CoordinateSystemParser(DeegreeCRSProvider<StAXResource> provider, URL configURL)

Method Summary

protected QName	expectedRootName()
List<CRSCodeType[]>	getAvailableCRSs()
CoordinateSystem	getCRSForId(String crsId)
protected List<Transformation>	parseAlternativeTransformations(XMLStreamReader reader) Parse all polynomial transformations for a given crs.
protected Axis	parseAxis(XMLStreamReader reader) Parses an axis element
protected Axis[]	parseAxisOrder(XMLStreamReader reader) Creates an axis array for the given crs element.
protected CoordinateSystem	parseCompoundCRS(XMLStreamReader reader)
CoordinateSystem	parseCoordinateSystem(XMLStreamReader reader)
protected CoordinateSystem	parseGeocentricCRS(XMLStreamReader reader)
protected CoordinateSystem	parseGeographicCRS(XMLStreamReader reader)
protected CoordinateSystem	parseProjectedCRS(XMLStreamReader reader)
protected GeodeticDatum	parseReferencedGeodeticDatum(XMLStreamReader reader, String parentID) Parses the required usedDatum element from the given parentElement (probably a crs element).
Transformation	parseTransformation(org.apache.axiom.om.OMElement transformationDefinition) Retrieves a transformation from the resource.

Methods inherited from class org.deegree.crs.configuration.deegree.xml.stax.parsers.DefinitionParser

getConfigReader, getConfigURL, getProvider, moveReaderToNextIdentifiable, moveReaderToNextIdentifiable, parseIdentifiable, parseLatLonType, parseUnit, readEntireFile

Methods inherited from class java.lang.Object

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

Constructor Detail

CoordinateSystemParser

public CoordinateSystemParser(DeegreeCRSProvider<StAXResource> provider,
                              URL configURL)

Parameters:

provider - to be used for callback.

configURL - to be used for the configuration.

Method Detail

getCRSForId

public CoordinateSystem getCRSForId(String crsId)
                             throws CRSConfigurationException

Parameters:

crsId -

Returns:

the

Throws:

CRSConfigurationException

parseCoordinateSystem

public CoordinateSystem parseCoordinateSystem(XMLStreamReader reader)
                                       throws CRSConfigurationException,
                                              XMLStreamException

Parameters:

reader - to be parsed

Returns:

an instance of the given crs or null if the crsDefinition is null or could not be mapped to a valid type.

Throws:

CRSConfigurationException - if something went wrong while constructing the crs.

XMLStreamException

parseAxisOrder

protected Axis[] parseAxisOrder(XMLStreamReader reader)
                         throws CRSConfigurationException,
                                XMLStreamException

Creates an axis array for the given crs element.

Parameters:

reader - to be parsed from

Returns:

an Array of axis defining their order.

Throws:

CRSConfigurationException - if a required element could not be found, or an xmlParsingException occurred, or the axisorder uses names which were not defined in the axis elements.

XMLStreamException

parseAxis

protected Axis parseAxis(XMLStreamReader reader)
                  throws XMLStreamException,
                         XMLParsingException

Parses an axis element

Parameters:

reader -

Returns:

the parsed axis element

Throws:

XMLStreamException

XMLParsingException

parseTransformation

public Transformation parseTransformation(org.apache.axiom.om.OMElement transformationDefinition)

Retrieves a transformation from the resource.

Parameters:

transformationDefinition -

Returns:

the parsed transformation or null if no transformation could be parsed.

parseAlternativeTransformations

protected List<Transformation> parseAlternativeTransformations(XMLStreamReader reader)

Parse all polynomial transformations for a given crs.

Parameters:

reader - to parse the transformations for.

Returns:

the list of transformations or the empty list if no transformations were found. Never null.

parseProjectedCRS

protected CoordinateSystem parseProjectedCRS(XMLStreamReader reader)
                                      throws CRSConfigurationException,
                                             XMLStreamException

Parameters:

reader - from which the crs is to be created (using chached datums, conversioninfos and projections).

Returns:

a projected coordinatesystem based on the given xml-element.

Throws:

CRSConfigurationException - if a required element could not be found, or an xmlParsingException occurred.

XMLStreamException

parseGeographicCRS

protected CoordinateSystem parseGeographicCRS(XMLStreamReader reader)
                                       throws CRSConfigurationException,
                                              XMLStreamException

Parameters:

reader - positioned on the crs to be created (using cached datums, conversioninfos and projections).

Returns:

a geographic coordinatesystem based on the given xml-element.

Throws:

CRSConfigurationException - if a required element could not be found, or an xmlParsingException occurred.

XMLStreamException

parseGeocentricCRS

protected CoordinateSystem parseGeocentricCRS(XMLStreamReader reader)
                                       throws CRSConfigurationException,
                                              XMLStreamException

Parameters:

reader - from which the crs is to be created (using cached datums, conversioninfos and projections).

Returns:

a geocentric coordinatesystem based on the given xml-element.

Throws:

CRSConfigurationException - if a required element could not be found, or an xmlParsingException occurred.

XMLStreamException

parseCompoundCRS

protected CoordinateSystem parseCompoundCRS(XMLStreamReader reader)
                                     throws XMLStreamException

Parameters:

reader - from which the crs is to be created.

Returns:

a compound coordinatesystem based on the given xml-element.

Throws:

XMLStreamException

CRSConfigurationException - if a required element could not be found, or an xmlParsingException occurred.

parseReferencedGeodeticDatum

protected GeodeticDatum parseReferencedGeodeticDatum(XMLStreamReader reader,
                                                     String parentID)
                                              throws CRSConfigurationException,
                                                     XMLStreamException

Parses the required usedDatum element from the given parentElement (probably a crs element).

Parameters:

reader - pointing to the required usedDatum element from.

parentID - optional for an appropriate error message.

Returns:

the Datum.

Throws:

CRSConfigurationException - if a parsing error occurred, the node was not defined or an illegal id reference (not found) was given.

XMLStreamException

expectedRootName

protected QName expectedRootName()

Specified by:

expectedRootName in class DefinitionParser

Returns:

the top level element of a configuration file.

getAvailableCRSs

public List<CRSCodeType[]> getAvailableCRSs()

Returns:

the list of all available crs id's