deegree 2.3 (2010/04/09 10:10 build-4-official)

org.deegree.crs.configuration.proj4
Class PROJ4CRSProvider

java.lang.Object
  extended by org.deegree.crs.configuration.AbstractCRSProvider<Map<String,String>>
      extended by org.deegree.crs.configuration.proj4.PROJ4CRSProvider
All Implemented Interfaces:
CRSProvider

public class PROJ4CRSProvider
extends AbstractCRSProvider<Map<String,String>>

The PROJ4CRSProvider class is capable of parsing the nad/epsg file and use it as a backend for crs's. This class also adds following identifiers to the coordinatesystems.

Version:
$Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18. Jun 2009) $
Author:
Rutger Bezema, last edited by: $Author: mschneider $

Nested Class Summary
 
Nested classes/interfaces inherited from class org.deegree.crs.configuration.AbstractCRSProvider
AbstractCRSProvider.SupportedProjectionParameters, AbstractCRSProvider.SupportedProjections, AbstractCRSProvider.SupportedTransformationParameters, AbstractCRSProvider.SupportedTransformations
 
Constructor Summary
PROJ4CRSProvider()
          Export constructor, sets the version to current date..
PROJ4CRSProvider(Properties properties)
          Opens a reader on the file and parses all parameters with id, without instantiating any CoordinateSystems.
 
Method Summary
 boolean canExport()
           
 void export(StringBuilder sb, List<CoordinateSystem> crsToExport)
          Exports the crs to the implemented format.
 List<String> getAvailableCRSIds()
          This method should be called if one is only interested in the available identifiers and not in the coordinatesystems themselves.
 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.
 Identifiable getIdentifiable(String id)
          This method is more general than the CRSProvider.getCRSByID(String), because it represents a possibility to return an arbitrary Identifiable Object from the providers backend.
protected  ProjFileResource getResolver()
           
 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  CoordinateSystem parseCoordinateSystem(Map<String,String> crsDefinition)
           
 Transformation parseTransformation(Map<String,String> transformationDefinition)
           
 
Methods inherited from class org.deegree.crs.configuration.AbstractCRSProvider
addIdToCache, clearCache, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCRSByID, mapProjectionParameters, mapProjections, mapTransformation, mapTransformationParameters, setResolver
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PROJ4CRSProvider

public PROJ4CRSProvider()
Export constructor, sets the version to current date..


PROJ4CRSProvider

public PROJ4CRSProvider(Properties properties)
Opens a reader on the file and parses all parameters with id, without instantiating any CoordinateSystems.

Parameters:
properties - containing a crs.configuration property referencing a file location.
Method Detail

getResolver

protected ProjFileResource getResolver()
Overrides:
getResolver in class AbstractCRSProvider<Map<String,String>>
Returns:
the resolver for a type.

getAvailableCRSs

public 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.

canExport

public boolean canExport()
Returns:
true if this provider can export a given crs.

export

public void export(StringBuilder sb,
                   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()

getAvailableCRSIds

public List<String> getAvailableCRSIds()
                                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.

getIdentifiable

public Identifiable getIdentifiable(String id)
                             throws CRSConfigurationException
Description copied from interface: CRSProvider
This method is more general than the CRSProvider.getCRSByID(String), because it represents a possibility to return an arbitrary Identifiable Object from the providers backend.

Parameters:
id - string representation of the resource to retrieve
Returns:
the Identifiable 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.

parseCoordinateSystem

protected CoordinateSystem parseCoordinateSystem(Map<String,String> crsDefinition)
                                          throws CRSConfigurationException
Specified by:
parseCoordinateSystem in class AbstractCRSProvider<Map<String,String>>
Parameters:
crsDefinition - containing the definition of a crs in the understood type.
Returns:
a CoordinateSystem instance initialized with values from the given type definition fragment or null if the given crsDefinition is null or not known.
Throws:
CRSConfigurationException - if an error was found in the given crsDefintion

parseTransformation

public Transformation parseTransformation(Map<String,String> transformationDefinition)
                                   throws CRSConfigurationException
Specified by:
parseTransformation in class AbstractCRSProvider<Map<String,String>>
Parameters:
transformationDefinition - 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

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.

deegree 2.3 (2010/04/09 10:10 build-4-official)

an open source project founded by lat/lon, Bonn, Germany.
For more information visit: http://www.deegree.org