org.geotools.referencing.factory.epsg
Class AnsiDialectEpsgFactory

java.lang.Object
  extended by org.geotools.factory.AbstractFactory
      extended by org.geotools.referencing.factory.ReferencingFactory
          extended by org.geotools.referencing.factory.AbstractAuthorityFactory
              extended by org.geotools.referencing.factory.AbstractCachedAuthorityFactory
                  extended by org.geotools.referencing.factory.epsg.AbstractEpsgFactory
                      extended by org.geotools.referencing.factory.epsg.AnsiDialectEpsgFactory
All Implemented Interfaces:
javax.imageio.spi.RegisterableService, BufferedFactory, Factory, org.opengis.referencing.AuthorityFactory, org.opengis.referencing.crs.CRSAuthorityFactory, org.opengis.referencing.cs.CSAuthorityFactory, org.opengis.referencing.datum.DatumAuthorityFactory, org.opengis.referencing.operation.CoordinateOperationAuthorityFactory
Direct Known Subclasses:
OracleDialectEpsgFactory

public class AnsiDialectEpsgFactory
extends AbstractEpsgFactory

An EPSG factory for the database generated by SQL scripts rather than the MS-Access one. This class overrides adaptSQL(java.lang.String) in order to translate SQL statements from MS-Access syntax to ANSI syntax. By default, the translated SQL statements use the table and field names in the Data Description Language (DDL) scripts provided by EPSG to create the schema for the database. Subclasses can changes this default behavior by modifying the map.

References:

Since:
2.4
Version:
$Id: AnsiDialectEpsgFactory.java 30641 2008-06-12 17:42:27Z acuster $
Author:
Rueben Schulz, Martin Desruisseaux, Didier Richard, John Grange

Field Summary
protected  java.util.Map map
          Maps the MS-Access names to ANSI names.
 
Fields inherited from class org.geotools.referencing.factory.epsg.AbstractEpsgFactory
dataSource
 
Fields inherited from class org.geotools.referencing.factory.AbstractCachedAuthorityFactory
cache, factories
 
Fields inherited from class org.geotools.referencing.factory.ReferencingFactory
LOGGER
 
Fields inherited from class org.geotools.factory.AbstractFactory
hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority
 
Constructor Summary
AnsiDialectEpsgFactory(Hints userHints)
          Constructs an authority factory, the hints should describe the data source it use.
AnsiDialectEpsgFactory(Hints hints, java.sql.Connection connection)
          Constructs an authority factory using the specified connection.
AnsiDialectEpsgFactory(Hints hints, javax.sql.DataSource dataSource)
          Constructs an authority factory using the specified connection.
 
Method Summary
protected  java.lang.String adaptSQL(java.lang.String statement)
          Modifies the given SQL string to be suitable for non MS-Access databases.
protected  void setSchema(java.lang.String schema)
          Replaces the "epsg_" prefix by the specified schema name.
 
Methods inherited from class org.geotools.referencing.factory.epsg.AbstractEpsgFactory
connect, disconnect, dispose, finalize, generateAuthorityCodes, generateCoordinateOperation, generateCoordinateReferenceSystem, generateCoordinateSystem, generateCoordinateSystemAxis, generateDatum, generateEllipsoid, generateExtent, generateFromCoordinateReferenceSystemCodes, generateObject, generateOperationMethod, generateParameterDescriptor, generatePrimeMeridian, generateUnit, getAuthority, getBackingStoreDescription, getConnection, getDescriptionText, getImplementationHints, isPrimaryKey, shutdown
 
Methods inherited from class org.geotools.referencing.factory.AbstractCachedAuthorityFactory
createCartesianCS, createCompoundCRS, createCoordinateOperation, createCoordinateReferenceSystem, createCoordinateSystem, createCoordinateSystemAxis, createCylindricalCS, createDatum, createDerivedCRS, createEllipsoid, createEllipsoidalCS, createEngineeringCRS, createEngineeringDatum, createFromCoordinateReferenceSystemCodes, createGeocentricCRS, createGeodeticDatum, createGeographicCRS, createImageCRS, createImageDatum, createObject, createPolarCS, createPrimeMeridian, createProjectedCRS, createSphericalCS, createTemporalCRS, createTemporalDatum, createTimeCS, createUnit, createVerticalCRS, createVerticalCS, createVerticalDatum, getAuthorityCodes, getIdentifiedObjectFinder, noSuchAuthorityCode, toKey, trimAuthority
 
Methods inherited from class org.geotools.referencing.factory.AbstractAuthorityFactory
createExtent, createOperationMethod, createParameterDescriptor, noSuchAuthorityCode
 
Methods inherited from class org.geotools.referencing.factory.ReferencingFactory
ensureNonNull, getVendor
 
Methods inherited from class org.geotools.factory.AbstractFactory
addImplementationHints, equals, getPriority, hashCode, onDeregistration, onRegistration, toString
 
Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.opengis.referencing.Factory
getVendor
 

Field Detail

map

protected final java.util.Map map
Maps the MS-Access names to ANSI names. Keys are MS-Access names including bracket. Values are ANSI names. Keys and values are case-sensitive. The default content of this map is:
MS-Access name ANSI name
[Alias] epsg_alias
[Area] epsg_area
[Coordinate Axis] epsg_coordinateaxis
[Coordinate Axis Name] epsg_coordinateaxisname
[Coordinate_Operation] epsg_coordoperation
[Coordinate_Operation Method] epsg_coordoperationmethod
[Coordinate_Operation Parameter] epsg_coordoperationparam
[Coordinate_Operation Parameter Usage] epsg_coordoperationparamusage
[Coordinate_Operation Parameter Value] epsg_coordoperationparamvalue
[Coordinate_Operation Path] epsg_coordoperationpath
[Coordinate Reference System] epsg_coordinatereferencesystem
[Coordinate System] epsg_coordinatesystem
[Datum] epsg_datum
[Naming System] epsg_namingsystem
[Ellipsoid] epsg_ellipsoid
[Prime Meridian] epsg_primemeridian
[Supersession] epsg_supersession
[Unit of Measure] epsg_unitofmeasure
[CA.ORDER] coord_axis_order
Subclasses can modify this map in their constructor in order to provide a different mapping.

Constructor Detail

AnsiDialectEpsgFactory

public AnsiDialectEpsgFactory(Hints userHints)
                       throws org.opengis.referencing.FactoryException
Constructs an authority factory, the hints should describe the data source it use.

Parameters:
userHints - The underlying factories used for objects creation.
Throws:
org.opengis.referencing.FactoryException

AnsiDialectEpsgFactory

public AnsiDialectEpsgFactory(Hints hints,
                              java.sql.Connection connection)
Constructs an authority factory using the specified connection.

Parameters:
userHints - The underlying factories used for objects creation.
connection - The connection to the underlying EPSG database.
Throws:
org.opengis.referencing.FactoryException

AnsiDialectEpsgFactory

public AnsiDialectEpsgFactory(Hints hints,
                              javax.sql.DataSource dataSource)
Constructs an authority factory using the specified connection.

Parameters:
userHints - The underlying factories used for objects creation.
dataSource - Used to create a connection to the underlying EPSG database
Throws:
org.opengis.referencing.FactoryException
Method Detail

setSchema

protected void setSchema(java.lang.String schema)
Replaces the "epsg_" prefix by the specified schema name. If the removal of the "epsg_" prefix is not wanted, append it to the schema name (e.g. "myschema.epsg_"). This method should be invoked at construction time only.

Parameters:
schema - The database schema in which the epsg tables are stored.

adaptSQL

protected java.lang.String adaptSQL(java.lang.String statement)
Modifies the given SQL string to be suitable for non MS-Access databases. This replaces table and field names in the SQL with the new names in the SQL DDL scripts provided with EPSG database.

Specified by:
adaptSQL in class AbstractEpsgFactory
Parameters:
statement - The statement in MS-Access syntax.
Returns:
The SQL statement in ANSI syntax.


Copyright © 1996-2010 Geotools. All Rights Reserved.