org.deegree.cs.persistence.deegree.db
Class DBCRSStore

java.lang.Object
  org.deegree.cs.persistence.AbstractCRSStore
      org.deegree.cs.persistence.deegree.db.DBCRSStore

All Implemented Interfaces:

CRSStore

public class DBCRSStore
extends AbstractCRSStore

TODO add class documentation here This class have to be implemented - it's just an skeleton for the EPSGDBSynchronizer, yet!

Version:

$Revision: $, $Date: $

Author:

Lyn Buesching, last edited by: $Author: lyn $

Nested Class Summary

Nested classes/interfaces inherited from class org.deegree.cs.persistence.AbstractCRSStore

AbstractCRSStore.RESOURCETYPE

Constructor Summary

DBCRSStore(TransformationFactory.DSTransform prefTransformType)

Method Summary

List<CRSCodeType[]>	getAvailableCRSCodes() This method should be called if one is only interested in the available identifiers and not in the coordinatesystems themselves.
List<ICRS>	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.
ICRS	getCoordinateSystem(String id)
CRSResource	getCRSResource(CRSCodeType id) This method is more general than the CRSStore.getCRSByCode(CRSCodeType), because it represents a possibility to return an arbitrary CRSResource Object from the providers backend.
Transformation	getDirectTransformation(ICRS sourceCRS, ICRS targetCRS) This method is should retrieve a transformation which transforms coordinates from the given source into the given target crs.
Transformation	getDirectTransformation(String id) This method should retrieve a transformation with the given id.
void	init() Called by the manager to indicate that this CRSStore instance is being registered.

Methods inherited from class org.deegree.cs.persistence.AbstractCRSStore

addIdToCache, clearCache, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCachedIdentifiable, getCRSByCode, getCRSByCode, getPreferedTransformationType, resolve

Methods inherited from class java.lang.Object

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

Constructor Detail

DBCRSStore

public DBCRSStore(TransformationFactory.DSTransform prefTransformType)

Method Detail

init

public void init()

Description copied from interface: CRSStore

Called by the manager to indicate that this CRSStore instance is being registered.

getAvailableCRSs

public List<ICRS> getAvailableCRSs()
                            throws CRSConfigurationException

Description copied from interface: CRSStore

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.

getAvailableCRSCodes

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

Description copied from interface: CRSStore

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.

getCoordinateSystem

public ICRS getCoordinateSystem(String id)

Specified by:

getCoordinateSystem in class AbstractCRSStore

Returns:

getDirectTransformation

public Transformation getDirectTransformation(ICRS sourceCRS,
                                              ICRS targetCRS)
                                       throws CRSConfigurationException

Description copied from interface: CRSStore

This method is should retrieve a transformation 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.

getDirectTransformation

public Transformation getDirectTransformation(String id)
                                       throws CRSConfigurationException

Description copied from interface: CRSStore

This method should retrieve a transformation with the given id. If a transformation with the given id could not be found null should be returned.

Parameters:

id - the id of the transformation

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.

getCRSResource

public CRSResource getCRSResource(CRSCodeType id)
                           throws CRSConfigurationException

Description copied from interface: CRSStore

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

Parameters:

id - string representation of the resource to retrieve

Returns:

the CRSResource 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.