org.deegree.cs.configuration.gml
Class GMLCRSProvider

java.lang.Object
  org.deegree.cs.configuration.AbstractCRSProvider<org.apache.axiom.om.OMElement>
      org.deegree.cs.configuration.gml.GMLCRSProvider

All Implemented Interfaces:

CRSProvider

public class GMLCRSProvider
extends AbstractCRSProvider<org.apache.axiom.om.OMElement>

The GMLCRSProvider is a provider for a GML 3.2 backend, this may be a dictionary or a database. Note: not all of the GML3.2. features are implemented yet, but the basics (transformations, crs's, axis, units, projections) should work quite well.

Version:

$Revision: 23539 $, $Date: 2010-04-12 13:24:29 +0200 (Mo, 12. Apr 2010) $

Author:

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

Constructor Summary

GMLCRSProvider(java.util.Properties properties)
The 'default constructor' which will be called by the CRSConfiguration

Method Summary

boolean	canExport()
protected Helmert	createHelmert(CRSIdentifiable id, java.util.List<Pair<CRSIdentifiable,java.lang.Object>> parameterValues, CoordinateSystem source, CoordinateSystem target) Creates a Helmert transformation from the given parameter list.
protected NTv2Transformation	createNTv2(CRSIdentifiable id, java.util.List<Pair<CRSIdentifiable,java.lang.Object>> parameterValues, CoordinateSystem source, CoordinateSystem target) Create an NTv2Transformation from the given parameter list.
void	export(java.lang.StringBuilder sb, java.util.List<CoordinateSystem> crsToExport) Exports the crs to the implemented format.
java.util.List<CRSCodeType[]>	getAvailableCRSCodes() This method should be called if one is only interested in the available identifiers and not in the coordinatesystems themselves.
java.util.List<CoordinateSystem>	getAvailableCRSs() This method should be called to see if the provider is able to create all defined crs's, thus verifying the correctness of the configuration.
CRSIdentifiable	getIdentifiable(CRSCodeType id) This method is more general than the CRSProvider.getCRSByCode(CRSCodeType), because it represents a possibility to return an arbitrary CRSIdentifiable Object from the providers backend.
protected org.apache.axiom.om.OMElement	getRequiredXlinkedElement(org.apache.axiom.om.OMElement propertyElement, java.lang.String alternativeXPath) convenience method to retrieve a given required element either by resolving a optional xlink or by evaluating the required element denoted by the xpath.
Transformation	getTransformation(CoordinateSystem sourceCRS, CoordinateSystem targetCRS) This method is should retrieve a transformation (chain) which transforms coordinates from the given source into the given target crs.
protected Axis	parseAxis(org.apache.axiom.om.OMElement rootElement)
protected Axis[]	parseAxisFromCSType(org.apache.axiom.om.OMElement rootElement) For the ellipsoidal and cartesian cs Types, this method also checks the consistency of axis (radian, radian, [metre] ) or (metre, metre, [metre] ).
protected CompoundCRS	parseCompoundCRS(org.apache.axiom.om.OMElement rootElement) This methods parses the given element and maps it onto a CompoundCRS.
protected CoordinateSystem	parseCoordinateSystem(org.apache.axiom.om.OMElement rootElement)
protected GeodeticDatum	parseDatum(org.apache.axiom.om.OMElement rootElement)
protected Ellipsoid	parseEllipsoid(org.apache.axiom.om.OMElement rootElement)
protected CoordinateSystem	parseGeodeticCRS(org.apache.axiom.om.OMElement rootElement)
Transformation	parseGMLTransformation(org.apache.axiom.om.OMElement rootElement, CoordinateSystem sourceCRS, CoordinateSystem targetCRS) Parses some of the gml 3.2 transformation constructs.
CRSIdentifiable	parseIdentifiedObject(org.apache.axiom.om.OMElement rootElement)
protected Pair<CRSIdentifiable,java.lang.Object>	parseParameterValue(org.apache.axiom.om.OMElement rootElement)
protected java.util.List<Pair<CRSIdentifiable,java.lang.Object>>	parseParameterValues(org.apache.axiom.om.OMElement rootElement)
protected PrimeMeridian	parsePrimeMeridian(org.apache.axiom.om.OMElement rootElement)
protected CoordinateSystem	parseProjectedCRS(org.apache.axiom.om.OMElement rootElement)
protected Projection	parseProjection(org.apache.axiom.om.OMElement rootElement, GeographicCRS underlyingCRS) For now this method actually wraps all information in a gml:AbstractGeneralConversionType (or a derived subtype) into an CRSIdentifiable Object (used for the Projections).
Transformation	parseTransformation(org.apache.axiom.om.OMElement rootElement) Calls parseGMLTransformation for the catching of XMLParsingException.
protected Unit	parseUnitOfMeasure(org.apache.axiom.om.OMElement elementContainingUOMAttribute) Returns the unit defined by the uomAttribute given of the given element.
protected VerticalCRS	parseVerticalCRS(org.apache.axiom.om.OMElement rootElement)
protected VerticalDatum	parseVerticalDatum(org.apache.axiom.om.OMElement rootElement)
protected org.apache.axiom.om.OMElement	retrieveAndResolveXLink(org.apache.axiom.om.OMElement rootElement) Retrieves the xlink:href of the given rootElement and use the XLinkResolver to resolve the xlink if it was given.
protected java.lang.String	retrieveXLink(org.apache.axiom.om.OMElement rootElement) Find an xlink:href attribute and return it's value, if not found, the empty String will be returned.

Methods inherited from class org.deegree.cs.configuration.AbstractCRSProvider

addIdToCache, clearCache, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCRSByCode, getCRSByCode, getResolver, setResolver

Methods inherited from class java.lang.Object

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

Constructor Detail

GMLCRSProvider

public GMLCRSProvider(java.util.Properties properties)

The 'default constructor' which will be called by the CRSConfiguration

Parameters:

properties - the properties which can hold information about the configuration of this GML provider.

Method Detail

canExport

public boolean canExport()

Returns:

true if this provider can export a given crs.

export

public void export(java.lang.StringBuilder sb,
                   java.util.List<CoordinateSystem> crsToExport)

Description copied from interface: CRSProvider

Exports the crs to the implemented format. Try calling CRSProvider.canExport() before executing this method.

Parameters:

sb - the StringBuilder which will contain the exported version of the given crs.

crsToExport - the CoordinateSystems to export.

See Also:

CRSProvider.canExport()

getAvailableCRSCodes

public java.util.List<CRSCodeType[]> getAvailableCRSCodes()
                                                   throws CRSConfigurationException

Description copied from interface: CRSProvider

This method should be called if one is only interested in the available identifiers and not in the coordinatesystems themselves.

Returns:

the identifiers of all configured CRSs.

Throws:

CRSConfigurationException - if the implementation was confronted by an exception and could not deliver the requested crs. This exception should not be thrown if no CoordinateSystems were found, in the latter case an empty List ( a list with size == 0 ) should be returned.

getAvailableCRSs

public java.util.List<CoordinateSystem> getAvailableCRSs()
                                                  throws CRSConfigurationException

Description copied from interface: CRSProvider

This method should be called to see if the provider is able to create all defined crs's, thus verifying the correctness of the configuration.

Returns:

all configured CRSs.

Throws:

CRSConfigurationException - if the implementation was confronted by an exception and could not deliver the requested crs. This exception should not be thrown if no CoordinateSystems were found, in the latter case an empty List ( a list with size == 0 ) should be returned.

parseCoordinateSystem

protected CoordinateSystem parseCoordinateSystem(org.apache.axiom.om.OMElement rootElement)
                                          throws CRSConfigurationException

Specified by:

parseCoordinateSystem in class AbstractCRSProvider<org.apache.axiom.om.OMElement>

Parameters:

rootElement - containing a gml:CRS dom representation.

Returns:

a CoordinateSystem instance initialized with values from the given XML-OM gml:CRS fragment or null if the given root element is null

Throws:

CRSConfigurationException - if something went wrong.

parseTransformation

public Transformation parseTransformation(org.apache.axiom.om.OMElement rootElement)
                                   throws CRSConfigurationException

Calls parseGMLTransformation for the catching of XMLParsingException.

Specified by:

parseTransformation in class AbstractCRSProvider<org.apache.axiom.om.OMElement>

Parameters:

rootElement - containing the parameters needed to build a Transformation.

Returns:

a Transformation instance initialized with values from the given definition or null if the given transformationDefintion is null. If the parsed transformation is not supported or a NotSupportedTransformation will be returned.

Throws:

CRSConfigurationException - if an error was found in the given crsDefintion

parseGMLTransformation

public Transformation parseGMLTransformation(org.apache.axiom.om.OMElement rootElement,
                                             CoordinateSystem sourceCRS,
                                             CoordinateSystem targetCRS)
                                      throws XMLParsingException,
                                             java.io.IOException

Parses some of the gml 3.2 transformation constructs. Currently only helmert transformations are supported.

Parameters:

rootElement -

sourceCRS - to be used as the source crs, if null the values from the given transformation will be parsed.

targetCRS - to be used as the target crs, if null the values from the given transformation will be parsed.

Returns:

the transformation.

Throws:

XMLParsingException

java.io.IOException

createHelmert

protected Helmert createHelmert(CRSIdentifiable id,
                                java.util.List<Pair<CRSIdentifiable,java.lang.Object>> parameterValues,
                                CoordinateSystem source,
                                CoordinateSystem target)

Creates a Helmert transformation from the given parameter list.

Parameters:

id - of the transformation.

parameterValues - the list of values, the Object must be a Double (denoting a the rotation/translation/ppm of the helmert.)

source - to go from

target - to go to

Returns:

a helmert transformation matrix from the given parameter list.

createNTv2

protected NTv2Transformation createNTv2(CRSIdentifiable id,
                                        java.util.List<Pair<CRSIdentifiable,java.lang.Object>> parameterValues,
                                        CoordinateSystem source,
                                        CoordinateSystem target)

Create an NTv2Transformation from the given parameter list.

Parameters:

id - of the transformation.

parameterValues - the list of values, the Object must be a String (denoting a gridshift file url.)

source - to go from

target - to go to

Returns:

an NTv2Transformation if a file was given, null otherwise.

parseIdentifiedObject

public CRSIdentifiable parseIdentifiedObject(org.apache.axiom.om.OMElement rootElement)
                                      throws XMLParsingException

Parameters:

rootElement - which is a subtype of gml:IdentifiedObject and gml:DefinitionType or gml:AbstractCRSType

Returns:

the CRSIdentifiable instance, its values are filled with the values of the given gml instance.

Throws:

XMLParsingException - if the given rootElement could not be parsed.

parseCompoundCRS

protected CompoundCRS parseCompoundCRS(org.apache.axiom.om.OMElement rootElement)
                                throws XMLParsingException,
                                       java.io.IOException

This methods parses the given element and maps it onto a CompoundCRS. Currently only gml:CompoundCRS 's consisting of following combination is supported:

• Projected CRS with VerticalCRS

Geographic crs with a height axis can be mapped in a CompoundCRS by calling the parseGeodeticCRS(OMElement)

Parameters:

rootElement - containing a gml:CompoundCRS dom representation.

Returns:

a CompoundCRS instance initialized with values from the given XML-OM gml:CompoundCRS fragment.

Throws:

XMLParsingException

java.io.IOException

parseProjectedCRS

protected CoordinateSystem parseProjectedCRS(org.apache.axiom.om.OMElement rootElement)
                                      throws XMLParsingException,
                                             java.io.IOException

Parameters:

rootElement - containing a gml:ProjectedCRS dom representation.

Returns:

a ProjectedCRS instance initialized with values from the given XML-OM gml:ProjectedCRS fragment or null if the given root element is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException - if a retrieval of an xlink of one of the subelements failed.

parseGeodeticCRS

protected CoordinateSystem parseGeodeticCRS(org.apache.axiom.om.OMElement rootElement)
                                     throws XMLParsingException,
                                            java.io.IOException

Parameters:

rootElement - containing a gml:GeodeticCRS dom representation.

Returns:

a CoordinateSystem instance initialized with values from the given XML-OM gml:GeodeticCRS fragment or null if the given root element is null. Note the result may be a CompoundCRS, a GeographicCRS or a GeocentricCRS, depending of the definition of the CS type.

Throws:

XMLParsingException

java.io.IOException

parseDatum

protected GeodeticDatum parseDatum(org.apache.axiom.om.OMElement rootElement)
                            throws java.io.IOException,
                                   XMLParsingException

Parameters:

rootElement - containing a gml:GeodeticDatum dom representation.

Returns:

a GeodeticDatum instance initialized with values from the given XML-OM fragment or null if the given root element is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException - if a retrieval of an xlink of one of the subelements failed.

parseAxisFromCSType

protected Axis[] parseAxisFromCSType(org.apache.axiom.om.OMElement rootElement)
                              throws XMLParsingException,
                                     java.io.IOException

For the ellipsoidal and cartesian cs Types, this method also checks the consistency of axis (radian, radian, [metre] ) or (metre, metre, [metre] ). If the conditions are not met, an xml parsing exception will be thrown as well.

Parameters:

rootElement - containing a (Ellipsoidal, Spherical, Cartesian) CS type dom representation.

Returns:

a Axis array instance initialized with values from the given XML-OM fragment or null if the given root element is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException - if a retrieval of an xlink of one of the subelements failed.

parseAxis

protected Axis parseAxis(org.apache.axiom.om.OMElement rootElement)
                  throws XMLParsingException

Parameters:

rootElement - containing an gml:CoordinateSystemAxis type dom representation.

Returns:

an Axis instance initialized with values from the given XML-OM fragment or null if the given root element is null if the axis could not be mapped it's orientation will be Axis.AO_OTHER

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

parseEllipsoid

protected Ellipsoid parseEllipsoid(org.apache.axiom.om.OMElement rootElement)
                            throws XMLParsingException

Parameters:

rootElement - containing a gml:Ellipsoid dom representation.

Returns:

a Ellipsoid instance initialized with values from the given XML-OM fragment or null if the given root element is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

parsePrimeMeridian

protected PrimeMeridian parsePrimeMeridian(org.apache.axiom.om.OMElement rootElement)
                                    throws XMLParsingException

Parameters:

rootElement - to create the pm from.

Returns:

PrimeMeridian.GREENWICH or the appropriate pm if a longitude is defined.

Throws:

XMLParsingException

parseVerticalCRS

protected VerticalCRS parseVerticalCRS(org.apache.axiom.om.OMElement rootElement)
                                throws XMLParsingException,
                                       java.io.IOException

Parameters:

rootElement - containing a gml:VerticalCRS dom representation.

Returns:

a VerticalCRS instance initialized with values from the given XML-OM fragment or null if the given root element is null

Throws:

java.io.IOException

XMLParsingException - if the dom tree is not consistent or a required element is missing.

parseVerticalDatum

protected VerticalDatum parseVerticalDatum(org.apache.axiom.om.OMElement rootElement)
                                    throws XMLParsingException

Parameters:

rootElement - containing a gml:VerticalDatum dom representation.

Returns:

a VerticalDatum instance initialized with values from the given XML-OM fragment or null if the given root element is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

parseProjection

protected Projection parseProjection(org.apache.axiom.om.OMElement rootElement,
                                     GeographicCRS underlyingCRS)
                              throws XMLParsingException,
                                     java.io.IOException

For now this method actually wraps all information in a gml:AbstractGeneralConversionType (or a derived subtype) into an CRSIdentifiable Object (used for the Projections).

Parameters:

rootElement - a gml:GeneralConversion element

underlyingCRS - of the projection.

Returns:

a Projection (Conversion) containing the mapped values from the given gml:Conversion XML-OM-representation.

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException

parseParameterValues

protected java.util.List<Pair<CRSIdentifiable,java.lang.Object>> parseParameterValues(org.apache.axiom.om.OMElement rootElement)
                                                                               throws XMLParsingException,
                                                                                      java.io.IOException

Parameters:

rootElement - which should contain a list of parameter Value properties.

Returns:

a list of Pairs containing the parsed OperationParamter and the value as a double, converted to the units defined in the value element, or the empty list if the rootElement is null or no parameterValues were found.

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException

parseParameterValue

protected Pair<CRSIdentifiable,java.lang.Object> parseParameterValue(org.apache.axiom.om.OMElement rootElement)
                                                              throws XMLParsingException,
                                                                     java.io.IOException

Parameters:

rootElement - containing a parameter Value property.

Returns:

a Pair containing the parsed OperationParamter and the value as a double or null if the rootElement is null

Throws:

XMLParsingException - if the dom tree is not consistent or a required element is missing.

java.io.IOException

parseUnitOfMeasure

protected Unit parseUnitOfMeasure(org.apache.axiom.om.OMElement elementContainingUOMAttribute)
                           throws XMLParsingException

Returns the unit defined by the uomAttribute given of the given element. This method will use a 'colon' heuristic to determine if the given uom is actually an urn (and thus represents an xlink-type). This will then be resolved and mapped onto an unit.

Parameters:

elementContainingUOMAttribute - an element containing the 'uom' attribute which will be mapped onto a known unit.

Returns:

the mapped Unit or null if the given uomAttribute is empty or null, or no appropriate mapping could be found.

Throws:

XMLParsingException

getRequiredXlinkedElement

protected org.apache.axiom.om.OMElement getRequiredXlinkedElement(org.apache.axiom.om.OMElement propertyElement,
                                                                  java.lang.String alternativeXPath)
                                                           throws XMLParsingException,
                                                                  java.io.IOException

convenience method to retrieve a given required element either by resolving a optional xlink or by evaluating the required element denoted by the xpath.

Parameters:

propertyElement - to resolve an xlink from.

alternativeXPath - denoting a path to the required node starting from the given propertyElement.

Returns:

the dom-element in the xlink:href attribute of the given propertyElement or the required alternativeXPath element.

Throws:

XMLParsingException - if the given propertyElement is null or the resulting xml dom-tree could not be parsed or the alternative xpath does not result in an Element.

java.io.IOException - if the xlink could not be properly resolved

retrieveAndResolveXLink

protected org.apache.axiom.om.OMElement retrieveAndResolveXLink(org.apache.axiom.om.OMElement rootElement)
                                                         throws java.io.IOException

Retrieves the xlink:href of the given rootElement and use the XLinkResolver to resolve the xlink if it was given.

Parameters:

rootElement - to retrieve and resolve

Returns:

the resolved xlink:href attribute as an XML-OM element or null if the xlink could not be resolved (or was not given) or the rootElement is null.

Throws:

java.io.IOException

retrieveXLink

protected java.lang.String retrieveXLink(org.apache.axiom.om.OMElement rootElement)

Find an xlink:href attribute and return it's value, if not found, the empty String will be returned.

Parameters:

rootElement - to get the attribute from.

Returns:

the trimmed xlink:href attribute value or the empty String if not found or the rootElement is null;

getTransformation

public Transformation getTransformation(CoordinateSystem sourceCRS,
                                        CoordinateSystem targetCRS)
                                 throws CRSConfigurationException

Description copied from interface: CRSProvider

This method is should retrieve a transformation (chain) which transforms coordinates from the given source into the given target crs. If no such transformation could be found or the implementation does not support inverse lookup of transformations null should be returned.

Parameters:

sourceCRS - start of the transformation (chain)

targetCRS - end point of the transformation (chain).

Returns:

the Transformation Object or null if no such Object was found.

Throws:

CRSConfigurationException - if the implementation was confronted by an exception and could not deliver the requested Object. This exception should not be thrown no Transformation was found, in this case null should be returned.

getIdentifiable

public CRSIdentifiable getIdentifiable(CRSCodeType id)
                                throws CRSConfigurationException

Description copied from interface: CRSProvider

This method is more general than the CRSProvider.getCRSByCode(CRSCodeType), because it represents a possibility to return an arbitrary CRSIdentifiable Object from the providers backend.

Parameters:

id - string representation of the resource to retrieve

Returns:

the CRSIdentifiable Object or null if no such Object was found.

Throws:

CRSConfigurationException - if the implementation was confronted by an exception and could not deliver the requested Object. This exception should not be thrown if the given id wasn't found, in this case null should be returned.