Package org.apache.sis.referencing.factory.sql
package org.apache.sis.referencing.factory.sql
Factories for geodetic objects defined in a SQL database, typically the EPSG dataset.
This package provides support for all codes prefixed by
"EPSG:"
in the Apache SIS's
list of authority codes.
The main class in this package is EPSGFactory
,
which requires a DataSource
providing connections to an EPSG database.
Connection to the database
By default Apache SIS uses Apache Derby, but the database can also be PostgreSQL or MS-Access. The database connection is obtained by the first of the following data sources which is found:- If a JNDI context exists,
the
DataSource
registered under the"java:comp/env/jdbc/SpatialMetadata"
name. - If the
SIS_DATA
environment variable is defined, a JDBC connection for the"jdbc:derby:$SIS_DATA/Databases/SpatialMetadata"
URL. - If the
"derby.system.home"
property is defined, a JDBC connection for the"jdbc:derby:SpatialMetadata"
URL. - If the
org.apache.sis.non-free:sis-embedded-data
module is present on the classpath, a read-only connection to the database in the JAR file.
The EPSG dataset
A widely-used factory is the EPSG geodetic dataset. EPSG codes are numerical identifiers. For example,"EPSG:4326"
is the EPSG identifier for the "WGS 84" geographic CRS.
As an extension, the Apache SIS implementation accepts names as well as numeric identifiers.
For example, the two following method calls fetch the same object:
createProjectedCRS("27572")
createProjectedCRS("NTF (Paris) / Lambert zone II")
Note: 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.
For more determinism, the numerical codes are preferred.
How deprecated entries are handled
When an error is discovered in a Coordinate Reference System (CRS) definition, the EPSG group does not apply the correction directly on the erroneous object (unless the correction is very minor). Instead, the erroneous object is deprecated and a new one is created. Apache SIS handles deprecated objects as below:- Deprecated objects are not listed in the collection returned by the
EPSGDataAccess.getAuthorityCodes(…)
method. - All method expecting an EPSG code in argument accept also the codes of deprecated objects.
- If a deprecated object is created by a call to
EPSGDataAccess.createFoo(…)
, a warning will be logged with a message proposing a replacement.
- Since:
- 0.7
- Version:
- 1.2
- See Also:
-
ClassesClassDescriptionA map of EPSG authority codes as keys and object names as values.A (name, description) pair for a coordinate system axis.Private structure for
EPSGDataAccess.createBursaWolfParameters(PrimeMeridian, Integer)
usage.Closes JDBC statements whenAuthorityCodes
is garbage collected.A lazy set ofCoordinateOperation
objects to be returned by theEPSGDataAccess.createFromCoordinateReferenceSystemCodes(String, String)
method.An implementation ofIdentifiedObjectFinder
which scans over a smaller set of authority codes.A condition to put in a SQLWHERE
clause.A condition for a floating point value with a tolerance.Data Access Object (DAO) creating geodetic objects from a JDBC connection to an EPSG database.A geodetic object factory backed by the EPSG database.Runs the SQL scripts for creating an EPSG database.Provides SQL scripts needed for creating a local copy of a dataset.The default implementation which use the scripts in the$SIS_DATA/Databases/ExternalSources
directory, if present.Converts the SQL statements from MS-Access dialect to standard SQL.Information about a specific table.