Package org.geotoolkit.referencing.factory

Factories and base classes for authority factories.

See: Description

Class Summary

Class	Description
AbstractAuthorityFactory	Base class for authority factories.
AllAuthoritiesFactory	An authority factory that delegates the object creation to an other factory determined from the authority part in "authority:code" arguments.
AuthorityFactoryAdapter	An authority factory which delegates CRS, CS or datum objects creation to some other factory implementations.
CachingAuthorityFactory	An authority factory that caches all objects created by an other factory.
DatumAliases	A datum factory that add aliases to a datum name before to delegates the datum creation to an other factory.
DirectAuthorityFactory	The base class for authority factories that create referencing object directly.
FactoryDependencies	Build a tree of factory dependencies, usually for printing to the console.
FallbackAuthorityFactory	A factory which delegates all object creation to a primary factory, and fallback on an other one if the primary factory failed.
IdentifiedObjectFinder	Lookups an object from an authority factory which is equal, ignoring metadata, to the specified object.
IdentifiedObjectSet<T extends IdentifiedObject>	A lazy set of identified objects.
MultiAuthoritiesFactory	An authority factory that delegates the object creation to an other factory determined from the authority part in "authority:code" arguments.
OrderedAxisAuthorityFactory	An authority factory which delegates all the work to an other factory, and reorder the axis in some pre-determined order.
ReferencingFactory	Base class for all factories in the referencing module.
ReferencingFactoryContainer	A container of factories frequently used together, with utility methods.
ReferencingObjectFactory	Builds Geotk implementations of CRS, CS and datum objects.
ThreadedAuthorityFactory	A caching authority factory which delegates to different instances of a backing store for concurrency in multi-thread environment.
TransformedAuthorityFactory	An authority factory which returns modified CRS, CS or datum objects from other factory implementations.

Exception Summary

Exception	Description
NoSuchFactoryException	Thrown when a requested factory has not been found.
NoSuchIdentifiedResource	Thrown when a coordinate operation needs an external resource, and that resource has not been found.

Package org.geotoolkit.referencing.factory Description

Factories and base classes for authority factories.

Authority factories

The authority factories can be divided in three categories:

• Subclasses of DirectAuthorityFactory do the real work of creating Coordinate Reference System objects from authority codes. They differ in the way their data are stored:

  • DirectEpsgFactory uses a connection to an EPSG database,
  • DirectPostgisFactory uses a connection to a PostGIS "spatial_ref_sys" table, and
  • PropertyAuthorityFactory uses static WKT strings in a property file.

• Subclasses of CachingAuthorityFactory wrap the above DirectAuthorityFactories and cache their results, which lead to significant performance improvement. They may also use more than one direct authority factory instance for concurrency in multi-thread environment. Subclasses include:

  • ThreadedEpsgFactory which wraps a DirectEpsgFactory and
  • PropertyEpsgFactory which wraps a PropertyAuthorityFactory.

• Subclasses of AuthorityFactoryAdapter wraps the above CachingAuthorityFactories and apply some changes on the result in order to adapt them to a different usage context. The most common adaptation is to force the axis order to longitude first, which can be seen as an adaptation of Web Map Service (WMS) 1.3 objects to WMS 1.0 objects.

Since:

2.0

Version:

3.18

Author:

Martin Desruisseaux (IRD, Geomatys)