| org.geotools.referencing.factory.epsg.DataSource
All known Subclasses: org.geotools.referencing.factory.epsg.HSQLDataSource, org.geotools.referencing.factory.epsg.AccessDataSource, org.geotools.referencing.factory.epsg.SimpleDataSource, org.geotools.referencing.factory.epsg.PostgreDataSource,
| DataSource | | public interface DataSource extends javax.sql.DataSource(Code) | | A marker interface for data source to an EPSG database. This sub-interface of J2SE's
DataSource is used as a category for
javax.imageio.spi.ServiceRegistry .
EPSG data sources should be registered in the following file:
META-INF/services/org.geotools.referencing.factory.epsg.DataSource
For an example, see
org.geotools.referencing.factory.epsg.AccessDataSource and its
META-INF/services/ registration in the
plugin/epsg-access module. This is a very small module which can be used as a starting point for custom
EPSG data sources.
How EPSG factory are found
By default, only one
ThreadedEpsgFactory is registered and returned by
ReferencingFactoryFinder .
We don't need to register any other implementation for an EPSG factory backed by a SQL database.
However,
ThreadedEpsgFactory alone is not suffisient for querying the database. It needs one
more "plugable" information: the connection to the EPSG database. This
DataSource interface is there for providing such connection to
ThreadedEpsgFactory .
Some time after
ThreadedEpsgFactory is registered as an EPSG factory, it looks for a
DataSource using the same plugins mechanism than for factories. In other words,
DataSource is a second level of plugins used internally by
ThreadedEpsgFactory .
since:
2.1
version:
$Id: DataSource.java 25972 2007-06-21 13:38:35Z desruisseaux $
author:
Martin Desruisseaux javax.sql.DataSource ThreadedEpsgFactoryThreadedEpsgFactory META-INF/services |
| MAXIMUM_PRIORITY | | int MAXIMUM_PRIORITY(Code) | | The maximum priority for a data source, which is
.
Data sources with highest priority will be preferred to any other data sources.
|
| MINIMUM_PRIORITY | | int MINIMUM_PRIORITY(Code) | | The minimum priority for a data source, which is
.
Data sources with lowest priority will be used only if there is no other source available.
|
| NORMAL_PRIORITY | | int NORMAL_PRIORITY(Code) | | The default priority, which is
.
|
| createFactory | | AbstractAuthorityFactory createFactory(Hints hints) throws SQLException(Code) | | Opens a connection and creates an EPSG factory for it. This method may returns a
sub-class of
DirectEpsgFactory if it wants to use slightly different SQL queries.
Parameters:
hints - A map of hints, including the low-level factories to use for CRS creation.This argument should be given unchanged to DirectEpsgFactory constructor. The using SQL queries appropriatefor this data source.
throws:
SQLException - if connection to the database failed. |
|
|