org.geotools.referencing.factory.epsg

Class AnsiDialectEpsgFactory

Object

AbstractFactory

ReferencingFactory

AbstractAuthorityFactory

AbstractCachedAuthorityFactory

AbstractEpsgFactory

AnsiDialectEpsgFactory

All Implemented Interfaces:

BufferedFactory, Factory, RegistrableFactory, AuthorityFactory, CRSAuthorityFactory, CSAuthorityFactory, DatumAuthorityFactory, CoordinateOperationAuthorityFactory

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:

• EPSG geodecy parameters database readme at www.epsg.org

Since:

2.4

Author:

Rueben Schulz, Martin Desruisseaux, Didier Richard, John Grange

Field Summary

Fields

Modifier and Type	Field and Description
protected Map	map Maps the MS-Access names to ANSI names.

Fields inherited from class AbstractEpsgFactory

dataSource

Fields inherited from class AbstractCachedAuthorityFactory

cache, factories

Fields inherited from class ReferencingFactory

LOGGER

Fields inherited from class AbstractFactory

hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority

Constructor Summary

Constructors

Constructor and Description
AnsiDialectEpsgFactory(Hints userHints) Constructs an authority factory, the hints should describe the data source it use.
AnsiDialectEpsgFactory(Hints hints, Connection connection) Constructs an authority factory using the specified connection.
AnsiDialectEpsgFactory(Hints hints, DataSource dataSource) Constructs an authority factory using the specified connection.

Method Summary

Modifier and Type	Method and Description
protected String	adaptSQL(String statement) Modifies the given SQL string to be suitable for non MS-Access databases.
protected void	setSchema(String schema) Replaces the "epsg_" prefix by the specified schema name.

Methods inherited from class 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 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 AbstractAuthorityFactory

createExtent, createOperationMethod, createParameterDescriptor, noSuchAuthorityCode

Methods inherited from class ReferencingFactory

ensureNonNull, getVendor

Methods inherited from class AbstractFactory

addImplementationHints, equals, getPriority, hashCode, onDeregistration, onRegistration, toString

Methods inherited from class Object

clone, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Factory

getVendor

Field Detail

map

protected final 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 FactoryException

Constructs an authority factory, the hints should describe the data source it use.

Parameters:

userHints - The underlying factories used for objects creation.

Throws:

FactoryException

AnsiDialectEpsgFactory

public AnsiDialectEpsgFactory(Hints hints,
                              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:

FactoryException

AnsiDialectEpsgFactory

public AnsiDialectEpsgFactory(Hints hints,
                              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:

FactoryException

Method Detail

setSchema

protected void setSchema(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 String adaptSQL(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.