|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.geotools.factory.AbstractFactory org.geotools.referencing.factory.AbstractFactory org.geotools.referencing.factory.DatumAliases
A datum factory that add aliases to a datum name
before to delegates the datum creation to an other
factory. Aliases are especially important for datum since their
name are often the only way to differentiate them.
Two datum with different names are considered incompatible, unless some datum shift method are
specified (e.g. Bursa-Wolf parameters). Unfortunatly, different
softwares often use different names for the same datum,
which result in OperationNotFoundException
when attempting to convert coordinates from
one coordinate reference system to an other one. For
example "Nouvelle Triangulation Fran?aise (Paris)" and
"NTF (Paris meridian)" are actually the same datum. This
class provides a way to handle that.
is a class that determines if a datum name is in our list of aliases and
constructs a value for the aliases property (as
generic names) for a name. The default implementation is backed by
the text file "". The first line in this text file must be the
authority names. All other lines are the aliases.
Since is a datum factory, any authority
factory or any WKT parser using this
factory will takes advantage of the aliases table.
freeUnused()
automatically after some amount of time, in order to release
memory for unusued aliases. A timer should be set in method.Field Summary |
Fields inherited from class org.geotools.referencing.factory.AbstractFactory |
LOGGER |
Fields inherited from class org.geotools.factory.AbstractFactory |
hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority |
Constructor Summary | |
DatumAliases()
Constructs a new datum factory with the default backing factory and alias table. |
|
DatumAliases(org.opengis.referencing.datum.DatumFactory factory)
Constructs a new datum factory using the specified factory and the default alias table. |
|
DatumAliases(org.opengis.referencing.datum.DatumFactory factory,
java.net.URL aliasURL)
Constructs a new datum factory which delegates its work to the specified factory. |
Method Summary | |
org.opengis.referencing.datum.Ellipsoid |
createEllipsoid(java.util.Map properties,
double semiMajorAxis,
double semiMinorAxis,
javax.units.Unit unit)
Creates an ellipsoid from radius values. |
org.opengis.referencing.datum.EngineeringDatum |
createEngineeringDatum(java.util.Map properties)
Creates an engineering datum. |
org.opengis.referencing.datum.Ellipsoid |
createFlattenedSphere(java.util.Map properties,
double semiMajorAxis,
double inverseFlattening,
javax.units.Unit unit)
Creates an ellipsoid from an major radius, and inverse flattening. |
org.opengis.referencing.datum.GeodeticDatum |
createGeodeticDatum(java.util.Map properties,
org.opengis.referencing.datum.Ellipsoid ellipsoid,
org.opengis.referencing.datum.PrimeMeridian primeMeridian)
Creates geodetic datum from ellipsoid and (optionaly) Bursa-Wolf parameters. |
org.opengis.referencing.datum.ImageDatum |
createImageDatum(java.util.Map properties,
org.opengis.referencing.datum.PixelInCell pixelInCell)
Creates an image datum. |
org.opengis.referencing.datum.PrimeMeridian |
createPrimeMeridian(java.util.Map properties,
double longitude,
javax.units.Unit angularUnit)
Creates a prime meridian, relative to Greenwich. |
org.opengis.referencing.datum.TemporalDatum |
createTemporalDatum(java.util.Map properties,
java.util.Date origin)
Creates a temporal datum from an enumerated type value. |
org.opengis.referencing.datum.VerticalDatum |
createVerticalDatum(java.util.Map properties,
org.opengis.referencing.datum.VerticalDatumType type)
Creates a vertical datum from an enumerated type value. |
void |
freeUnused()
Free all aliases that have been unused up to date. |
Methods inherited from class org.geotools.referencing.factory.AbstractFactory |
ensureNonNull, getVendor |
Methods inherited from class org.geotools.factory.AbstractFactory |
getImplementationHints, onDeregistration, onRegistration |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.opengis.referencing.Factory |
getVendor |
Constructor Detail |
public DatumAliases()
public DatumAliases(org.opengis.referencing.datum.DatumFactory factory)
factory
- The factory to use for datum creation.public DatumAliases(org.opengis.referencing.datum.DatumFactory factory, java.net.URL aliasURL)
factory
- The factory to use for datum creation.aliasURL
- The url to the alias table.Method Detail |
public org.opengis.referencing.datum.EngineeringDatum createEngineeringDatum(java.util.Map properties) throws org.opengis.referencing.FactoryException
createEngineeringDatum
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.GeodeticDatum createGeodeticDatum(java.util.Map properties, org.opengis.referencing.datum.Ellipsoid ellipsoid, org.opengis.referencing.datum.PrimeMeridian primeMeridian) throws org.opengis.referencing.FactoryException
createGeodeticDatum
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.ellipsoid
- Ellipsoid to use in new geodetic datum.primeMeridian
- Prime meridian to use in new geodetic datum.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.ImageDatum createImageDatum(java.util.Map properties, org.opengis.referencing.datum.PixelInCell pixelInCell) throws org.opengis.referencing.FactoryException
createImageDatum
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.pixelInCell
- Specification of the way the image grid is associated
with the image data attributes.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.TemporalDatum createTemporalDatum(java.util.Map properties, java.util.Date origin) throws org.opengis.referencing.FactoryException
createTemporalDatum
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.origin
- The date and time origin of this temporal datum.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.VerticalDatum createVerticalDatum(java.util.Map properties, org.opengis.referencing.datum.VerticalDatumType type) throws org.opengis.referencing.FactoryException
createVerticalDatum
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.type
- The type of this vertical datum (often ?geoidal?).
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.Ellipsoid createEllipsoid(java.util.Map properties, double semiMajorAxis, double semiMinorAxis, javax.units.Unit unit) throws org.opengis.referencing.FactoryException
createEllipsoid
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.semiMajorAxis
- Equatorial radius in supplied linear units.semiMinorAxis
- Polar radius in supplied linear units.unit
- Linear units of ellipsoid axes.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.Ellipsoid createFlattenedSphere(java.util.Map properties, double semiMajorAxis, double inverseFlattening, javax.units.Unit unit) throws org.opengis.referencing.FactoryException
createFlattenedSphere
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.semiMajorAxis
- Equatorial radius in supplied linear units.inverseFlattening
- Eccentricity of ellipsoid.unit
- Linear units of major axis.
org.opengis.referencing.FactoryException
- if the object creation failed.public org.opengis.referencing.datum.PrimeMeridian createPrimeMeridian(java.util.Map properties, double longitude, javax.units.Unit angularUnit) throws org.opengis.referencing.FactoryException
createPrimeMeridian
in interface org.opengis.referencing.datum.DatumFactory
properties
- Name and other properties to give to the new object.longitude
- Longitude of prime meridian in supplied angular units East of Greenwich.angularUnit
- Angular units of longitude.
org.opengis.referencing.FactoryException
- if the object creation failed.public void freeUnused()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |