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
DataSourceproviding connections to an EPSG database.
Connection to the databaseBy 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,
DataSourceregistered under the
- If the
SIS_DATAenvironment variable is defined, a JDBC connection for the
- If the
"derby.system.home"property is defined, a JDBC connection for the
- If the
org.apache.sis.non-free:sis-embedded-datamodule is present on the classpath, a read-only connection to the database in the JAR file.
The EPSG datasetA 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("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 handledWhen 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
- 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.
- See Also:
Defined in the
Class Summary Class Description EPSGDataAccessData Access Object (DAO) creating geodetic objects from a JDBC connection to an EPSG database. EPSGFactoryA geodetic object factory backed by the EPSG database. InstallationScriptProviderProvides SQL scripts needed for creating a local copy of a dataset. SQLTranslatorConverts the SQL statements from MS-Access dialect to standard SQL.