org.deegree.cs
Class Transformer

java.lang.Object
  org.deegree.cs.Transformer

Direct Known Subclasses:

CoordinateTransformer, GeometryTransformer, RasterTransformer

public abstract class Transformer
extends java.lang.Object

Abstract base class for all transformers. Stores a target coordinate system and creates Transformation objects for a given source CRS.

Version:

$Revision: 24625 $, $Date: 2010-05-27 17:57:38 +0200 (Do, 27. Mai 2010) $

Author:

Oliver Tonnhofer, last edited by: $Author: rbezema $

Constructor Summary

protected	Transformer(CoordinateSystem targetCRS) Creates a new Transformer object, with the given target CRS.
protected	Transformer(CRS targetCRS) Creates a new Transformer object, with the given target CRS.
protected	Transformer(java.lang.String targetCRS) Creates a new Transformer object, with the given id as the target CRS.
protected	Transformer(Transformation definedTransformation)

Method Summary

protected Transformation	createCRSTransformation(CoordinateSystem sourceCRS) Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS.
protected Transformation	createCRSTransformation(CoordinateSystem sourceCRS, java.util.List<Transformation> toBeUsedTransformations) Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS.
protected Transformation	createCRSTransformation(java.lang.String sourceCRS) Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS.
CoordinateSystem	getTargetCRS()
CRS	getWrappedTargetCRS()

Methods inherited from class java.lang.Object

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

Constructor Detail

Transformer

protected Transformer(CoordinateSystem targetCRS)
               throws java.lang.IllegalArgumentException

Creates a new Transformer object, with the given target CRS.

Parameters:

targetCRS - to transform incoming coordinates to.

Throws:

java.lang.IllegalArgumentException - if the given CoordinateSystem is null

Transformer

protected Transformer(java.lang.String targetCRS)
               throws UnknownCRSException,
                      java.lang.IllegalArgumentException

Creates a new Transformer object, with the given id as the target CRS.

Parameters:

targetCRS - an identifier to which all incoming coordinates shall be transformed.

Throws:

UnknownCRSException - if the given crs name could not be mapped to a valid (configured) crs.

java.lang.IllegalArgumentException - if the given parameter is null.

Transformer

protected Transformer(CRS targetCRS)
               throws java.lang.IllegalArgumentException,
                      UnknownCRSException

Creates a new Transformer object, with the given target CRS.

Parameters:

targetCRS - to transform incoming coordinates to.

Throws:

java.lang.IllegalArgumentException - if the given CoordinateSystem is null

UnknownCRSException - if the wrapped crs was null

Transformer

protected Transformer(Transformation definedTransformation)

Parameters:

definedTransformation - to use instead of the CRSFactory.

Throws:

java.lang.IllegalArgumentException - if the given parameter is null.

Method Detail

createCRSTransformation

protected Transformation createCRSTransformation(CoordinateSystem sourceCRS)
                                          throws TransformationException,
                                                 java.lang.IllegalArgumentException

Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS.

Parameters:

sourceCRS - in which the coordinates are defined.

Returns:

the Transformation chain.

Throws:

TransformationException - if no transformation chain could be created.

java.lang.IllegalArgumentException - if the given CoordinateSystem is null

createCRSTransformation

protected Transformation createCRSTransformation(CoordinateSystem sourceCRS,
                                                 java.util.List<Transformation> toBeUsedTransformations)
                                          throws TransformationException

Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS. The list of transformations can be used to define separate transformations which must be used into the resulting transformation chain.

Parameters:

sourceCRS - in which the coordinates are defined.

toBeUsedTransformations - a list of transformations which must be used on the resulting transformation chain.

Returns:

the Transformation chain.

Throws:

TransformationException

TransformationException - if no transformation chain could be created.

java.lang.IllegalArgumentException - if the given CoordinateSystem is null

createCRSTransformation

protected Transformation createCRSTransformation(java.lang.String sourceCRS)
                                          throws TransformationException,
                                                 java.lang.IllegalArgumentException,
                                                 UnknownCRSException

Creates a transformation chain, which can be used to transform incoming coordinates (in the given source CRS) into this Transformer's targetCRS.

Parameters:

sourceCRS - in which the coordinates are defined.

Returns:

the Transformation chain.

Throws:

TransformationException - if no transformation chain could be created.

java.lang.IllegalArgumentException - if the given CoordinateSystem is null

UnknownCRSException - if the given crs name could not be mapped to a valid (configured) crs.

getTargetCRS

public final CoordinateSystem getTargetCRS()

Returns:

the targetCRS

getWrappedTargetCRS

public final CRS getWrappedTargetCRS()

Returns:

the target crs as a wrapped CRS