Package org.geotools.referencing.operation

Class ManyCoordinateOperationFactory

Object

AbstractFactory

ReferencingFactory

AbstractCoordinateOperationFactory

DefaultCoordinateOperationFactory

ManyCoordinateOperationFactory

All Implemented Interfaces:

Factory, ObjectFactory, CoordinateOperationFactory, Factory, RegistrableFactory

public class ManyCoordinateOperationFactory
extends DefaultCoordinateOperationFactory

A CoordinateOperationFactory that delegates to multiple underlying factories, returning the first set of results it finds from any of them.

Field Summary

Fields inherited from class DefaultCoordinateOperationFactory

PIVOT_CRS_LIST_KEY

Fields inherited from class AbstractCoordinateOperationFactory

AXIS_CHANGES, DATUM_SHIFT, ELLIPSOID_SHIFT, GEOCENTRIC_CONVERSION, IDENTITY, INVERSE_OPERATION

Fields inherited from class ReferencingFactory

LOGGER

Fields inherited from class AbstractFactory

hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority

Constructor Summary

Constructors

Constructor	Description
ManyCoordinateOperationFactory(Hints hints)

Method Summary

Modifier and Type	Method	Description
protected CoordinateOperation	createFromDatabase(CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS)	If the coordinate operation is explicitly defined in some database (typically EPSG), returns it.
Set<CoordinateOperation>	findFromDatabase(CoordinateReferenceSystem sourceCRS, CoordinateReferenceSystem targetCRS, int limit)	Returns a list of available coordinate operations explicitly defined in some database (typically EPSG), for the provided CRS pair.

Methods inherited from class DefaultCoordinateOperationFactory

createOperation, createOperation, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, createOperationStep, findOperations, findOperations, findOperationSteps, findOperationSteps, findOperationSteps, findOperationSteps, findOperationSteps, findOperationSteps, tryWellKnownPivots

Methods inherited from class AbstractCoordinateOperationFactory

concatenate, concatenate, concatenate, concatenate, createConcatenatedOperation, createDefiningConversion, createFromAffineTransform, createFromMathTransform, createFromMathTransform, createFromParameters, ensureNonNull, getErrorMessage, getImplementationHints, getMathTransformFactory, inverse, swapAndScaleAxis

Methods inherited from class ReferencingFactory

getVendor

Methods inherited from class AbstractFactory

addImplementationHints, equals, getPriority, hashCode, onDeregistration, onRegistration, toString

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Factory

getVendor

Constructor Details

ManyCoordinateOperationFactory

public ManyCoordinateOperationFactory(Hints hints)

Method Details

createFromDatabase

protected CoordinateOperation createFromDatabase(CoordinateReferenceSystem sourceCRS,
 CoordinateReferenceSystem targetCRS)

Description copied from class: DefaultCoordinateOperationFactory

If the coordinate operation is explicitly defined in some database (typically EPSG), returns it. Otherwise (if there is no database, or if the database doesn't contains an explicit operation from sourceCRS to targetCRS, or if this method failed to create an operation from the database), returns null.

The default implementation always returns null, since there is no database connected to a DefaultCoordinateOperationFactory instance. In other words, the default implementation is "standalone": it tries to figure out transformation paths by itself. Subclasses should override this method if they can fetch a more accurate operation from some database. The mean subclass doing so is AuthorityBackedFactory.

This method is invoked by createOperation(sourceCRS, targetCRS) before to try to figure out a transformation path by itself. It is also invoked by various createOperationStep(...) methods when an intermediate CRS was obtained by GeneralDerivedCRS.getBaseCRS() (this case occurs especially during geographic from/to projected CRS operations). This method is not invoked for synthetic CRS generated by createOperationStep(...), since those temporary CRS are not expected to exist in a database.

Overrides:

createFromDatabase in class DefaultCoordinateOperationFactory

Parameters:

sourceCRS - Input coordinate reference system.

targetCRS - Output coordinate reference system.

Returns:

A coordinate operation from sourceCRS to targetCRS if and only if one is explicitly defined in some underlying database, or null otherwise.

findFromDatabase

public Set<CoordinateOperation> findFromDatabase(CoordinateReferenceSystem sourceCRS,
 CoordinateReferenceSystem targetCRS,
 int limit)

Description copied from class: DefaultCoordinateOperationFactory

Returns a list of available coordinate operations explicitly defined in some database (typically EPSG), for the provided CRS pair. Otherwise (if there is no database, or if the database doesn't contains any explicit operation from sourceCRS to targetCRS, or if this method failed to create the operations from the database), returns an empty Set.

The default implementation always returns an empty Set, since there is no database connected to a DefaultCoordinateOperationFactory instance. In other words, the default implementation is "standalone": it tries to figure out transformation paths by itself. Subclasses should override this method if they can fetch a more accurate operation from some database. The mean subclass doing so is AuthorityBackedFactory.

This method is invoked by findOperations(sourceCRS, targetCRS) before to try to figure out a transformation path by itself. It is also invoked by various findOperationSteps(...) methods when an intermediate CRS was obtained by GeneralDerivedCRS.getBaseCRS() (this case occurs especially during geographic from/to projected CRS operations). This method is not invoked for synthetic CRS generated by createOperationStep(...), since those temporary CRS are not expected to exist in a database.

Specified by:

findFromDatabase in interface CoordinateOperationFactory

Overrides:

findFromDatabase in class DefaultCoordinateOperationFactory

Parameters:

sourceCRS - Input coordinate reference system.

targetCRS - Output coordinate reference system.

limit - The maximum number of operations to be returned. Use -1 to return all the available operations. Use 1 to return just one operations. Currently, the behavior for other values of limit is undefined.

Returns:

A set of coordinate operations from sourceCRS to targetCRS if and only if one is explicitly defined in some underlying database, or an empty Set otherwise.