Package org.geotools.referencing.factory

Class Abstract_URI_AuthorityFactory

Object

AbstractFactory

ReferencingFactory

AbstractAuthorityFactory

AuthorityFactoryAdapter

Abstract_URI_AuthorityFactory

All Implemented Interfaces:

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

Direct Known Subclasses:

HTTP_URI_AuthorityFactory, URN_AuthorityFactory

public abstract class Abstract_URI_AuthorityFactory
extends AuthorityFactoryAdapter
implements CRSAuthorityFactory, CSAuthorityFactory, DatumAuthorityFactory, CoordinateOperationAuthorityFactory

Base class for building OGC URN and HTTP URI wrappers around AllAuthoritiesFactory.

Author:

Justin Deoliveira, Martin Desruisseaux, Ben Caradoc-Davies (CSIRO Earth Science and Resource Engineering)

Field Summary

Fields inherited from class ReferencingFactory

LOGGER

Fields inherited from class AbstractFactory

hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority

Constructor Summary

Constructors

Constructor	Description
Abstract_URI_AuthorityFactory(String hintsAuthority)	Creates a default wrapper
Abstract_URI_AuthorityFactory(AllAuthoritiesFactory factory)	Creates a wrapper around the specified factory.
Abstract_URI_AuthorityFactory(Hints userHints, String hintsAuthority)	Creates a wrapper using the specified hints.

Method Summary

Modifier and Type	Method	Description
protected abstract URI_Parser	buildParser(String code)	Subclasses must implement this method to return a subclass of URI_Parser appropriate to their URI.
protected AuthorityFactory	createVersionedFactory(Version version)	Invoked when a factory is requested for a specific version.
abstract Citation	getAuthority()	Returns the organization or party responsible for definition and maintenance of the database.
protected AuthorityFactory	getAuthorityFactory(String code)	Returns an object factory for the specified code.
protected CoordinateOperationAuthorityFactory	getCoordinateOperationAuthorityFactory(String code)	Returns the coordinate operation factory to use for the specified URI.
protected CRSAuthorityFactory	getCRSAuthorityFactory(String code)	Returns the coordinate reference system factory to use for the specified URI.
protected CSAuthorityFactory	getCSAuthorityFactory(String code)	Returns the coordinate system factory to use for the specified URI.
protected DatumAuthorityFactory	getDatumAuthorityFactory(String code)	Returns the datum factory to use for the specified URI.
protected String	toBackingFactoryCode(String code)	Returns a simple authority code (like "EPSG:4236") that can be passed to the wrapped factories.

Methods inherited from class AuthorityFactoryAdapter

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, dispose, getAuthorityCodes, getBackingStoreDescription, getDescriptionText, getIdentifiedObjectFinder, getVendor, isAvailable, notifySuccess

Methods inherited from class AbstractAuthorityFactory

noSuchAuthorityCode, trimAuthority

Methods inherited from class ReferencingFactory

ensureNonNull

Methods inherited from class AbstractFactory

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

Methods inherited from class Object

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

Methods inherited from interface AuthorityFactory

createObject, getAuthorityCodes, getDescriptionText

Methods inherited from interface CoordinateOperationAuthorityFactory

createCoordinateOperation, createFromCoordinateReferenceSystemCodes

Methods inherited from interface CRSAuthorityFactory

createCompoundCRS, createCoordinateReferenceSystem, createDerivedCRS, createEngineeringCRS, createGeocentricCRS, createGeographicCRS, createImageCRS, createProjectedCRS, createTemporalCRS, createVerticalCRS

Methods inherited from interface CSAuthorityFactory

createCartesianCS, createCoordinateSystem, createCoordinateSystemAxis, createCylindricalCS, createEllipsoidalCS, createPolarCS, createSphericalCS, createTimeCS, createUnit, createVerticalCS

Methods inherited from interface DatumAuthorityFactory

createDatum, createEllipsoid, createEngineeringDatum, createGeodeticDatum, createImageDatum, createPrimeMeridian, createTemporalDatum, createVerticalDatum

Methods inherited from interface Factory

getImplementationHints

Methods inherited from interface Factory

getVendor

Constructor Detail

Abstract_URI_AuthorityFactory

public Abstract_URI_AuthorityFactory(String hintsAuthority)

Creates a default wrapper

Parameters:

hintsAuthority - the name used to reference thi factory in Hints.FORCE_AXIS_ORDER_HONORING.

Abstract_URI_AuthorityFactory

public Abstract_URI_AuthorityFactory(Hints userHints,
                                     String hintsAuthority)

Creates a wrapper using the specified hints. For strict compliance with OGC definitions, the supplied hints should contains at least the FORCE_LONGITUDE_FIRST_AXIS_ORDER hint with value FALSE.

Parameters:

userHints - The hints to be given to backing factories.

hintsAuthority - the name used to reference thi factory in Hints.FORCE_AXIS_ORDER_HONORING.

Abstract_URI_AuthorityFactory

public Abstract_URI_AuthorityFactory(AllAuthoritiesFactory factory)

Creates a wrapper around the specified factory. The supplied factory is given unchanged to the super class constructor.

Method Detail

buildParser

protected abstract URI_Parser buildParser(String code)
                                   throws NoSuchAuthorityCodeException

Subclasses must implement this method to return a subclass of URI_Parser appropriate to their URI.

Parameters:

code - the URI to be parsed

Throws:

NoSuchAuthorityCodeException

getAuthority

public abstract Citation getAuthority()

Description copied from class: AuthorityFactoryAdapter

Returns the organization or party responsible for definition and maintenance of the database.

Specified by:

getAuthority in interface AuthorityFactory

Overrides:

getAuthority in class AuthorityFactoryAdapter

Returns:

The organization reponsible for definition of the database.

See Also:

AuthorityFactoryAdapter.getAuthority()

getAuthorityFactory

protected AuthorityFactory getAuthorityFactory(String code)
                                        throws FactoryException

Returns an object factory for the specified code. This method invokes one of the get TypeAuthorityFactory methods where Type is inferred from the code.

Overrides:

getAuthorityFactory in class AuthorityFactoryAdapter

Parameters:

code - The authority code given to this class.

Returns:

A factory for the specified authority code (never null).

Throws:

FactoryException - if no suitable factory were found.

getDatumAuthorityFactory

protected DatumAuthorityFactory getDatumAuthorityFactory(String code)
                                                  throws FactoryException

Returns the datum factory to use for the specified URI. If the URI contains a version string, then this method will try to fetch a factory for that particular version. The createVersionedFactory(org.geotools.util.Version) method may be invoked for that purpose. If no factory is provided for that specific version, then the default one is used.

Overrides:

getDatumAuthorityFactory in class AuthorityFactoryAdapter

Parameters:

code - The URI given to this class.

Returns:

A factory for the specified URI (never null).

Throws:

FactoryException - if no datum factory is available.

getCSAuthorityFactory

protected CSAuthorityFactory getCSAuthorityFactory(String code)
                                            throws FactoryException

Returns the coordinate system factory to use for the specified URI. If the URI contains a version string, then this method will try to fetch a factory for that particular version. The createVersionedFactory(org.geotools.util.Version) method may be invoked for that purpose. If no factory is provided for that specific version, then the default one is used.

Overrides:

getCSAuthorityFactory in class AuthorityFactoryAdapter

Parameters:

code - The URI given to this class.

Returns:

A factory for the specified URI (never null).

Throws:

FactoryException - if no coordinate system factory is available.

getCRSAuthorityFactory

protected CRSAuthorityFactory getCRSAuthorityFactory(String code)
                                              throws FactoryException

Returns the coordinate reference system factory to use for the specified URI. If the URI contains a version string, then this method will try to fetch a factory for that particular version. The createVersionedFactory(org.geotools.util.Version) method may be invoked for that purpose. If no factory is provided for that specific version, then the default one is used.

Overrides:

getCRSAuthorityFactory in class AuthorityFactoryAdapter

Parameters:

code - The URI given to this class.

Returns:

A factory for the specified URI (never null).

Throws:

FactoryException - if no coordinate reference system factory is available.

getCoordinateOperationAuthorityFactory

protected CoordinateOperationAuthorityFactory getCoordinateOperationAuthorityFactory(String code)
                                                                              throws FactoryException

Returns the coordinate operation factory to use for the specified URI. If the URI contains a version string, then this method will try to fetch a factory for that particular version. The createVersionedFactory(org.geotools.util.Version) method may be invoked for that purpose. If no factory is provided for that specific version, then the default one is used.

Overrides:

getCoordinateOperationAuthorityFactory in class AuthorityFactoryAdapter

Parameters:

code - The URI given to this class.

Returns:

A factory for the specified URI (never null).

Throws:

FactoryException - if no coordinate operation factory is available.

createVersionedFactory

protected AuthorityFactory createVersionedFactory(Version version)
                                           throws FactoryException

Invoked when a factory is requested for a specific version. This method should create a factory for the exact version specified by the argument, or return null if no such factory is available. In the later case, this class will fallback on the factory specified at construction time.

Parameters:

version - The version for the factory to create.

Returns:

The factory, of null if there is none for the specified version.

Throws:

FactoryException - if an error occurred while creating the factory.

toBackingFactoryCode

protected String toBackingFactoryCode(String code)
                               throws FactoryException

Returns a simple authority code (like "EPSG:4236") that can be passed to the wrapped factories.

Overrides:

toBackingFactoryCode in class AuthorityFactoryAdapter

Parameters:

code - The code given to this factory.

Returns:

The code to give to the underlying factories.

Throws:

FactoryException - if the code can't be converted.