Package org.geotoolkit.referencing.factory.epsg

Authority factories for the EPSG database.

See:
Description

Class Summary

AnsiDialectEpsgFactory	An EPSG factory for the database generated by ANSI-compatible SQL scripts.
DirectEpsgFactory	A CRS authority factory backed by the EPSG database tables.
EpsgInstaller	Installs the EPSG database.
EpsgInstaller.Result	A simple data structure holding the result of an EPSG database creation.
LongitudeFirstEpsgFactory	An EPSG authority factory using (longitude, latitude) axis order.
PropertyEpsgFactory	Authority factory for Coordinate Reference Systems beyong the one defined in the EPSG database.
ThreadedEpsgFactory	The EPSG factory registered in AuthorityFactoryFinder.

Package org.geotoolkit.referencing.factory.epsg Description

Authority factories for the EPSG database. Every classes in this package except PropertyEpsgFactory require a connection to a database, which may be on Derby (a.k.a. JavaDB), HSQL, PostgreSQL or MS-Access.

Installation
See installation instructions.

Fetching a connection
By default, this package fetches a connection to a database in the Geotoolkit.org/EPSG directory (relative to the user home directory). This database will be automatically created if the geotk-epsg module is available on the classpath. The automatic installation and usage will work only if one of the derby.jar or hsql.jar driver is available on the classpath.

The connection to the database can also be specified explicitly in a simple properties file or through JNDI. The steps used for fetching the connection parameters are described in the javadoc of the ThreadedEpsgFactory.getDataSource() method.

Getting a factory instance
An EPSG authority factory is created using the following code:

CRSAuthorityFactory factory = AuthorityFactoryFinder.getCRSAuthorityFactory("EPSG", null);

How CRS are identified
EPSG codes are numerical identifiers. For example "4326" is the EPSG identifier for the "WGS 84" geographic CRS. However, the default implementation accepts names as well as numeric identifiers. For example "NTF (Paris) / France I" and "27581" both fetchs the same object. Note that names may be ambiguous since the same name may be used for more than one object. This is the case of "WGS 84" for example. If such an ambiguity is found, an exception will be thrown.

Since:

2.1

Version:

3.00

Author:

Martin Desruisseaux (IRD, Geomatys), Yann Cézard (IRD), Rueben Schulz (UBC), Matthias Basler, Andrea Aime (TOPP), Jody Garnett (Refractions), Didier Richard (IGN), John Grange

See Also:

List of authority codes

Module:

referencing/geotk-referencing (download)