org.geotools.referencing.factory.epsg
Class ThreadedPostgreSQLEpsgFactory
Object
AbstractFactory
ReferencingFactory
AbstractAuthorityFactory
BufferedAuthorityFactory
DeferredAuthorityFactory
ThreadedEpsgFactory
ThreadedPostgreSQLEpsgFactory
- All Implemented Interfaces:
- RegisterableService, BufferedFactory, Factory, OptionalFactory, AuthorityFactory, CRSAuthorityFactory, CSAuthorityFactory, DatumAuthorityFactory, CoordinateOperationAuthorityFactory
public class ThreadedPostgreSQLEpsgFactory
- extends ThreadedEpsgFactory
Connection to the EPSG database in PostgreSQL database engine using JDBC. The EPSG
database can be downloaded from http://www.epsg.org.
It should have been imported into a PostgreSQL database, which doesn't need to be on
the local machine.
Connection parameters
The preferred way to specify connection parameters is through the JNDI interface.
However, this datasource provides the following alternative as a convenience: if a
"EPSG-DataSource.properties" file is found in current directory or in the user's home
directory, then the following properties are fetch. Note that the default value may change
in a future version if a public server become available.
Property |
Type |
Description |
Geotools Default |
serverName |
String |
PostgreSQL database server host name |
localhost |
databaseName |
String |
PostgreSQL database name |
EPSG |
schema |
String |
The schema for the EPSG tables |
|
portNumber |
int |
TCP port which the PostgreSQL database server is listening on |
5432 |
user |
String |
User used to make database connections |
GeoTools |
password |
String |
Password used to make database connections |
GeoTools |
The database version is given in the
edition attribute
of the authority.
The postgreSQL database should be read only.
Just having this class accessible in the classpath, together with the registration in
the META-INF/services/
directory, is suffisient to get a working EPSG authority
factory backed by this database. Vendors can create a copy of this class, modify it and
bundle it with their own distribution if they want to connect their users to an other
database.
- Since:
- 2.4
- Author:
- Didier Richard, Martin Desruisseaux
- Tutorial:
- How to install the EPSG database in PostgreSQL
- Module:
modules/plugin/epsg-postgresql (gt-epsg-postgresql.jar)
Methods inherited from class BufferedAuthorityFactory |
createCartesianCS, createCompoundCRS, createCoordinateOperation, createCoordinateReferenceSystem, createCoordinateSystem, createCoordinateSystemAxis, createCylindricalCS, createDatum, createDerivedCRS, createEllipsoid, createEllipsoidalCS, createEngineeringCRS, createEngineeringDatum, createExtent, createFromCoordinateReferenceSystemCodes, createGeocentricCRS, createGeodeticDatum, createGeographicCRS, createImageCRS, createImageDatum, createObject, createOperationMethod, createParameterDescriptor, createPolarCS, createPrimeMeridian, createProjectedCRS, createSphericalCS, createTemporalCRS, createTemporalDatum, createTimeCS, createUnit, createVerticalCRS, createVerticalCS, createVerticalDatum, getAuthorityCodes, getBackingStoreDescription, getDescriptionText, getIdentifiedObjectFinder, getVendor |
CONFIGURATION_FILE
public static final String CONFIGURATION_FILE
- The user configuration file. This class search first for the first file found in the
following directories:
- The current directory
- The user's home directory
- See Also:
- Constant Field Values
ThreadedPostgreSQLEpsgFactory
public ThreadedPostgreSQLEpsgFactory()
- Creates a new instance of this factory.
ThreadedPostgreSQLEpsgFactory
public ThreadedPostgreSQLEpsgFactory(Hints hints)
- Creates a new instance of this factory with the specified hints.
The priority is set to a lower value than the FactoryOnAccess's one
in order to give the priority to any "official" database installed locally by the
user, when available.
createDataSource
protected DataSource createDataSource()
throws SQLException
- Returns a data source for the PostgreSQL database.
- Overrides:
createDataSource
in class ThreadedEpsgFactory
- Returns:
- The EPSG data source, or
null
if none where found.
- Throws:
SQLException
- if an error occured while creating the data source.
createBackingStore
protected AbstractAuthorityFactory createBackingStore(Hints hints)
throws SQLException
- Returns the backing-store factory for PostgreSQL syntax.
- Overrides:
createBackingStore
in class ThreadedEpsgFactory
- Parameters:
hints
- A map of hints, including the low-level factories to use for CRS creation.
- Returns:
- The EPSG factory using PostgreSQL syntax.
- Throws:
SQLException
- if connection to the database failed.
Copyright © 1996-2009 Geotools. All Rights Reserved.