| org.geotools.referencing.factory.epsg |
|
package org.geotools.referencing.factory.epsg
{@linkplain org.opengis.referencing.AuthorityFactory Authority factories} for
the EPSG database.
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 {@code "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.
An EPSG authority factory is created using the following code:
{@linkplain org.opengis.referencing.crs.CRSAuthorityFactory} factory =
{@linkplain org.geotools.referencing.ReferencingFactoryFinder}.getCRSAuthorityFactory("EPSG", null);
This package provides the general framework for accessing an EPSG database,
but the actual connection to a database requires the existence of an EPSG plugin in the classpath.
Otherwise, a {@link org.geotools.factory.FactoryNotFoundException} will be thrown. Available plugins are:
| Required software |
Data source |
Plugin / JAR file |
Additional notes |
| MS-Access ODBC driver |
{@link org.geotools.referencing.factory.epsg.FactoryOnAccess} |
{@code epsg-access} |
See installation instructions |
| HSQL embedded database |
{@link org.geotools.referencing.factory.epsg.FactoryOnHSQL} |
{@code epsg-hsql} |
Note for module mainteners |
| PostgreSQL database |
{@link org.geotools.referencing.factory.epsg.FactoryOnPostgreSQL} |
{@code epsg-postgresql} |
Note for module mainteners |
|
| Java Source File Name | Type | Comment |
| AccessDataSource.java | Class | Connection to the EPSG database in MS-Access format using JDBC-ODBC bridge. |
| AccessDialectEpsgFactory.java | Class | This factory uses the MS-Access dialect of SQL. |
| AllTests.java | Class | Performs all tests for the org.geotools.referencing.factory.epsg packages. |
| AnsiDialectEpsgFactory.java | Class | An EPSG factory for the database generated by SQL scripts rather than the MS-Access one.
This class overrides
AnsiDialectEpsgFactory.adaptSQL in order to translate SQL statements from
MS-Access syntax to ANSI syntax. |
| AuthorityCodes.java | Class | A set of EPSG authority codes. |
| AxisName.java | Class | A (name, description) pair for a coordinate system axis. |
| BursaWolfInfo.java | Class | Private structure for
DirectEpsgFactory.createBursaWolfParameters usage. |
| Compactor.java | Class | Compacts
INSERT TO ... |
| CoordinateOperationSet.java | Class | A lazy set of
CoordinateOperation objects to be returned by the
DirectEpsgFactory.createFromCoordinateReferenceSystemCodescreateFromCoordinateReferenceSystemCodes method. |
| DataSource.java | Interface | A marker interface for data source to an EPSG database. |
| DefaultFactory.java | Class | Base class for EPSG factories to be registered in
ReferencingFactoryFinder . |
| DefaultFactoryTest.java | Class | Tests transformations from CRS and/or operations created from the EPSG factory, using
the default plugin. |
| DirectEpsgFactory.java | Class | A coordinate reference system factory backed by the EPSG database tables.
The EPSG database is freely available at http://www.epsg.org.
Current version of this class requires EPSG database version 6.6 or above.
This factory doesn't cache any result. |
| EpsgFallbackTest.java | Class | Tests
FactoryUsingWKT as a fallback after
DefaultFactory . |
| EsriExtension.java | Class | Extends the EPSG database with
defined by ESRI. |
| EsriExtensionTest.java | Class | Tests ESRI CRS support. |
| FactoryOnAccess.java | Class | Connection to the EPSG database in MS-Access format using JDBC-ODBC bridge. |
| FactoryOnHSQL.java | Class | Connection to the EPSG database in HSQL database engine format using JDBC. |
| FactoryUsingAnsiSQL.java | Class | An EPSG factory for the database generated by SQL scripts rather than the MS-Access one. |
| FactoryUsingHSQL.java | Class | Adapts SQL statements for HSQL. |
| FactoryUsingSQL.java | Class | A coordinate reference system factory backed by the EPSG database tables. |
| FactoryUsingWKT.java | Class | Authority factory for
beyong the one defined in the EPSG database. |
| FactoryUsingWktTest.java | Class | Tests
FactoryUsingWKT . |
| FallbackAuthorityFactoryTest.java | Class | Checks the exception thrown by the fallback system do report actual errors when the code is
available but for some reason broken, and not "code not found" ones. |
| HSQLDataSource.java | Class | Connection to the EPSG database in HSQL database engine format using JDBC. |
| LongitudeFirstFactory.java | Class | An EPSG authority factory using (longitude, latitude) axis order.
This factory wraps a
ThreadedEpsgFactory into an
OrderedAxisAuthorityFactory when first needed.
Users don't need to create explicitly an instance of this class. |
| OperationFactoryTest.java | Class | Tests the usage of
CoordinateOperationFactory with the help of the
EPSG database. |
| PostgreDataSource.java | Class | Connection to the EPSG database in PostgreSQL database engine using JDBC. |
| SimpleDataSource.java | Class | Open a connection to an EPSG database using
DriverManager . |
| TableInfo.java | Class | Information about a specific table. |
| ThreadedEpsgFactory.java | Class | Base class for EPSG factories to be registered in
ReferencingFactoryFinder .
Various subclasses are defined for different database backends: Access, PostgreSQL,
HSQL, etc..
Users should not creates instance of this class directly. |
| ThreadedPostgreSQLEpsgFactory.java | Class | Connection to the EPSG database in PostgreSQL database engine using JDBC. |
| UnnamedExtension.java | Class | Provides common
not found in the standard EPSG database. |
| UnnamedExtensionTest.java | Class | Tests
UnnamedExtension . |